| name | tether |
| description | Tether (install/uninstall) chezmoi hooks to ~/.claude/settings.json. Renamed from 'hooks' to avoid clashing with Claude Code's. |
| allowed-tools | Read, Bash, TodoWrite, TodoRead |
| argument-hint | [install|uninstall|status|restore [latest|<n>]] |
| model | haiku |
| disable-model-invocation | true |
Dotfiles Hooks Manager
Manage chezmoi-sync-reminder hook installation in ~/.claude/settings.json.
Claude Code only loads hooks from settings.json, not from plugin.json files. This command installs/uninstalls the chezmoi PostToolUse hook that reminds you to sync dotfile changes.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Actions
| Action | Description |
|---|
status | Show current installation state |
install | Add chezmoi hook to settings.json |
uninstall | Remove chezmoi hook from settings.json |
restore | List available backups with numbers |
restore latest | Restore most recent backup |
restore <n> | Restore backup by number |
Execution
Parse $ARGUMENTS and run the management script:
/usr/bin/env bash << 'HOOKS_SCRIPT_EOF'
PLUGIN_DIR="$(cc-plugin-root dotfiles-tools)"
ACTION="${ARGUMENTS:-status}"
bash "$PLUGIN_DIR/scripts/manage-hooks.sh" $ACTION
HOOKS_SCRIPT_EOF
Post-Action Reminder
After install/uninstall/restore operations:
IMPORTANT: Restart Claude Code session for changes to take effect.
The hooks are loaded at session start. Modifications to settings.json require a restart.
Examples
/dotfiles-tools:tether status
/dotfiles-tools:tether install
/dotfiles-tools:tether uninstall
/dotfiles-tools:tether restore
/dotfiles-tools:tether restore latest
Troubleshooting
| Issue | Cause | Solution |
|---|
| jq not found | jq not installed | brew install jq |
| Already installed | Hook already in settings | Run uninstall first to reinstall |
| Hooks not working | Session not restarted | Restart Claude Code session |
| Settings file not found | ~/.claude/ doesn't exist | Create with mkdir -p ~/.claude |
| Invalid JSON | Corrupted settings.json | Use restore latest to recover from backup |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.
