/cs:handoff-setup
Configure the handoff skill. Walks 5 questions (plus 1-2 optional) and writes the config. Re-run any time.
Invocation
/cs:handoff-setup # configure global defaults
/cs:handoff-setup --project # set project-specific overrides
Questions
- Save location — OS temp / home folder / hidden home folder / per-project / custom. No pre-selected default — explicit choice required on first run.
- Retention window — 7 / 30 days / forever / manual.
- Redaction strictness — strict / warn / off.
- Git context — auto-include branch + last commit + dirty file count? yes/no.
- Skill recommendation scope — all repo / current domain only / off.
- Filename style (only if save location ≠ temp) — date_slug / timestamp / mktemp.
Behaviour
- Global config at
~/.config/handoff/config.json. - Project override at
<repo>/.handoff/config.json(with--project). Missing keys fall back to global. - For
save_location.mode = project, setup offers to append.handoff/to.gitignore. - Idempotent. Re-running pre-fills current values.
Reset to defaults
Delete the config and rerun:
rm ~/.config/handoff/config.json
rm ~/.config/handoff/.setup-declined 2>/dev/null
Run
python3 ${CLAUDE_PLUGIN_ROOT}/skills/handoff/scripts/setup.py
For project-scoped overrides:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/handoff/scripts/setup.py --reconfigure --project