Skill333 repo starsupdated 2d ago

guard

The guard command launches a background daemon that monitors Claude session memory usage and automatically applies pruning and reloading when configurable thresholds are exceeded. Use this for long-running agent team sessions where automatic compaction would otherwise discard team state, or whenever continuous memory management is needed without manual intervention.

View source Repository: cozempic

Install in Claude Code

Copy

git clone --depth 1 https://github.com/Ruya-AI/cozempic /tmp/guard && cp -r /tmp/guard/plugin/skills/guard ~/.claude/skills/guard

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

Start the cozempic guard daemon for continuous session protection.

## Default (recommended)

```bash
cozempic guard --daemon --threshold 50 -rx standard --interval 30
```

This runs in the background and:
1. Checkpoints team state every 30 seconds
2. At 60% of threshold (30MB): applies gentle prune, no reload
3. At threshold (50MB): applies full prescription + auto-reload with team state preserved

## For agent teams

Guard mode is **essential** for sessions running agent teams. Without it, auto-compaction triggers and the lead agent loses team state (TeamCreate, SendMessage, tasks are discarded).

## Options

- `--threshold N` — hard threshold in MB (default: 50)
- `--soft-threshold N` — soft threshold in MB (default: 60% of hard)
- `--threshold-tokens N` — hard threshold in tokens (fires whichever hits first)
- `--no-reload` — prune without restarting Claude
- `--no-reactive` — disable kqueue/polling file watcher
- `-rx NAME` — prescription at hard threshold (default: standard)

## Check status and stop

The daemon writes to `/tmp/cozempic_guard_*.log`. Check with:
```bash
ls /tmp/cozempic_guard_*.pid 2>/dev/null        # is it running?
tail -20 /tmp/cozempic_guard_*.log 2>/dev/null   # recent activity
kill "$(cat /tmp/cozempic_guard_*.pid)"           # stop it
```