checkpoint-watchlisted
Install: claude install-skill PHPCraftdream/cc-arch-hands
# checkpoint-watch
Arm (or disarm, or inspect) a per-project Stop hook that nudges you to
`/checkpoint` once the session's context window crosses 90% full. The hint is a
single soft `[hint]` line per session — the agent keeps working, and you decide
when to actually checkpoint. The hook runs the `cah-checkpoint-hint` bin shipped
by this package.
## When to use
- At the start of working in a project where you want an automatic reminder to
save state before Claude Code auto-compacts the context.
- Run `--status` any time to see whether the hook is armed in the current
project.
- Run `--off` to remove it.
## Usage
```
/checkpoint-watch # default: enable the Stop hook in this project
/checkpoint-watch --off # remove our Stop hook from this project
/checkpoint-watch --status # report whether our hook is present (no write)
```
This skill is **per-project**. It only ever touches
`<cwd>/.claude/settings.json`. It never touches the global
`~/.claude/settings.json`.
## Behavior
Resolve the local settings path: `<cwd>/.claude/settings.json`. For every mode
below, that single file is the target — never the global `~/.claude/settings.json`.
### Resolving the bin path
The hook command points at a JavaScript file that `cah install` copies into the
**global** bin directory `<HOME>/.claude/cah-bin/`, where `<HOME>` is the
current user's home directory. This absolute path is used even though this skill
is otherwise project-local — the bin always lives in the one