tether

name	tether
description	Tether (install/uninstall) statusline-tools Stop hook to ~/.claude/settings.json. Renamed from 'hooks' to avoid clashing with.
allowed-tools	Read, Bash, TodoWrite, TodoRead, AskUserQuestion
argument-hint	[install|uninstall|status]
model	haiku
disable-model-invocation	true

Navigation: Plugin CLAUDE.md | Root CLAUDE.md

Status Line Hooks Manager

Manage Stop hook installation for link validation and path linting.

The Stop hook runs at session end to:

1. Validate markdown links using lychee
2. Check for relative path violations using lint-relative-paths
3. Cache results for status line display

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
install	Add Stop hook to settings.json
uninstall	Remove Stop hook from settings.json
status	Show current hook configuration

Coexistence Note

This hook can coexist with other Stop hooks (like check-links-hybrid.sh). Both will run on session end - statusline-tools caches results for display, while other hooks may take different actions.

Execution

Skip Logic

• If action provided (install, uninstall, status) -> execute directly
• If no arguments -> check current status, then use AskUserQuestion flow

Workflow

1. Check Current State: Run status to show current hook configuration
2. Action Selection: Use AskUserQuestion to select action:
   • "Install hook" -> add Stop hook for link validation
   • "Uninstall hook" -> remove Stop hook
   • "Just show status" -> display and exit
3. Execute: Run the management script
4. Verify: Confirm changes applied

AskUserQuestion Flow (No Arguments)

When invoked without arguments, guide the user interactively:

Question: "What would you like to do with the statusline-tools Stop hook?"
Options:
  - "Install" -> "Add Stop hook for link validation and path linting on session end"
  - "Uninstall" -> "Remove the Stop hook from settings.json"
  - "Status" -> "Show current hook configuration"

Direct Execution (With Arguments)

Parse $ARGUMENTS and run the management script:

/usr/bin/env bash << 'HOOKS_SCRIPT_EOF'
PLUGIN_DIR="$(cc-plugin-root statusline-tools)"
ACTION="${ARGUMENTS:-status}"
bash "$PLUGIN_DIR/scripts/manage-hooks.sh" $ACTION
HOOKS_SCRIPT_EOF

Post-Action Reminder

After install/uninstall operations:

IMPORTANT: Restart Claude Code session for changes to take effect.

Hooks are loaded at session start. Modifications to settings.json require a restart.

Examples

# Check current installation status
/statusline-tools:tether status

# Install the Stop hook for link validation
/statusline-tools:tether install

# Uninstall hooks
/statusline-tools:tether uninstall

Troubleshooting

Issue	Cause	Solution
jq not found	jq not installed	brew install jq
lychee not found	Link validator not installed	brew install lychee
Hooks not working	Session not restarted	Restart Claude Code session
lint-relative-paths errors	Invalid path patterns	Check file paths in SKILL.md files
Cache stale	Stop hook failed	Check .lychee-results.json and .lint-relative-paths-results.txt in the git repo root

Note on hooks.json Hooks

cron-tracker.ts and stop-cron-gc.ts are registered directly in hooks.json and are not managed by manage-hooks.sh. They run automatically via the hooks framework and do not need manual install/uninstall.

Post-Execution Reflection

After this skill completes, check before closing:

1. Did the command succeed? — If not, fix the instruction or error table that caused the failure.
2. Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. 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.