Agent hooks

An agent turn is work, and it usually happens while an unrelated window is focused. Without these hooks a present minute of background agent work is credited to the focused window instead of the agent’s repo, so they are part of the install rather than an extra.

Claude Code

jq -s '.[1].hooks as $add | .[0] | .hooks = reduce ($add | keys[]) as $k (.hooks // {}; .[$k] = ((.[$k] // []) + $add[$k] | unique))' \
  ~/.claude/settings.json /usr/share/tagwerk/claude-hooks.json > ~/.claude/settings.json.new \
  && mv ~/.claude/settings.json.new ~/.claude/settings.json

claude-hooks.json adds SessionStart, UserPromptSubmit, PostToolUse and Stop hooks with 5 s timeouts. The jq line appends them to the hooks the settings already hold and is safe to rerun.

PostToolUse is not optional: without it a 20 min agentic turn loses minutes 10 to 20 once the beat lease runs out.

pi

ln -s /usr/share/tagwerk/pi/tagwerk.ts ~/.pi/agent/extensions/tagwerk.ts

pi runs under Bun with its own PATH, so the extension spawns /usr/bin/tagwerk by absolute path. Restart pi to load it.

Confirm both landed

Both installs fail quietly, which is how this ledger went six months without a single beat. tagwerk doctor reports each piece as wired or missing and reprints the command above for whichever is missing. See Verification for the full output.