llms.txt

# claude-code-toolkit

> Collection of fixes, hooks, guards, and extensions for Claude Code CLI

## Projects

- [agent-timeout-hook](agent-timeout-hook/): Subagents freeze indefinitely during execution with no timeout, no error, and no recovery path, requiring manual Ctrl+C to recover the entire session.
- [bg-task-respawn-limiter](bg-task-respawn-limiter/): Background bash tasks in Claude Code can respawn infinitely when commands hang, creating fork bombs that consume all system resources.
- [context-brief-statusline](context-brief-statusline/): The /context command output is too verbose for quick checks, showing full inventory listings when users just want to see how much context runway they have left.
- [context-image-tracker](context-image-tracker/): Images accumulate silently in conversation context and trigger dimension limit errors at low context usage, but users have no visibility into how many images are loaded.
- [conversation-path-migrator](conversation-path-migrator/): Claude Code conversations are tied to absolute directory paths and become inaccessible when a project folder is moved or renamed.
- [cron-file-sync](cron-file-sync/): Cron jobs created via CronCreate are session-scoped and live only in memory, causing inconsistencies when multiple sessions independently create or delete reminders.
- [db-migrate-guard](db-migrate-guard/): Claude Code can run destructive database migration commands like migrate:fresh that silently wipe production data when environment files are missing.
- [dispatch-session-cleaner](dispatch-session-cleaner/): Dispatch sessions fail silently due to stale local-agent-mode-sessions directories that persist after crashes, with no error message and no way to recover without manual filesystem cleanup.
- [dotfile-write-guard](dotfile-write-guard/): Claude Code repeatedly destroys critical user environment files like .bashrc and .aws/ without confirmation despite explicit instructions in CLAUDE.md to always confirm writes.
- [failure-memory-bank](failure-memory-bank/): Code repair agents repeat the same failed repair strategies because they don't learn from past failures within a session.
- [git-branch-refresh](git-branch-refresh/): The git branch label in Claude Code UI shows the branch from the original conversation start and never updates, even after switching branches and resuming with --resume.
- [image-size-guard](image-size-guard/): Pasting a large image into Claude Code causes the session to hang indefinitely when the base64-encoded image exceeds the 5MB API limit with no error message.
- [jsonl-content-fixer](jsonl-content-fixer/): Voice-dictated messages stored as plain strings instead of content arrays in JSONL conversation files cause context compaction to break message alternation and corrupt conversations permanently.
- [keychain-backup-hook](keychain-backup-hook/): Setting CLAUDE_CODE_OAUTH_TOKEN as an environment variable causes Claude Code to silently delete the macOS Keychain credential entry on exit, breaking all other sessions.
- [mcp-orphan-killer](mcp-orphan-killer/): MCP stdio servers silently lose their stdin pipe after 10-20 minutes and become orphaned processes with PPID=1 that accumulate across sessions.
- [multiline-statusline](multiline-statusline/): Multi-line statusLine output is concatenated into a single string and truncated to one terminal width, causing row 2+ to be cut off or lost entirely.
- [nested-config-guard](nested-config-guard/): Claude Code creates a nested ~/.claude/.claude/ directory when started from its own global config folder, saving project-local settings to the wrong location.
- [network-path-guard](network-path-guard/): Claude Code hangs indefinitely on startup when additionalDirectories in settings.json contains an unreachable network path with no timeout or error message.
- [oauth-parallel-guard](oauth-parallel-guard/): Multiple parallel agents cause 401 authentication errors because OAuth tokens are not properly validated or refreshed before concurrent agent spawns.
- [parentuuid-chain-repair](parentuuid-chain-repair/): API 403 retry mechanism corrupts parentUuid chains by pointing retry messages to subagent progress entries, causing entire conversation history to be lost on session resume.
- [permission-mode-restore](permission-mode-restore/): Bypass permission mode is permanently lost for the rest of a session after a PreToolUse hook returns an ask decision and the user approves the action.
- [plan-accept-guard](plan-accept-guard/): Claude Code auto-accepts pending plans when a session is re-initialized after idle time, executing plans the user intended to review or modify with their feedback.
- [sandbox-hook-enricher](sandbox-hook-enricher/): PreToolUse hooks have no way to know whether sandbox is enabled, forcing hook authors to fragily parse settings.json directly to respect the user's trust boundaries.
- [session-context-bridge](session-context-bridge/): Developers using multiple AI tools (Claude Code, Codex, Gemini) lose all context when switching between them, requiring re-explanation of project state in every new tool.
- [session-title-backfill](session-title-backfill/): CLI-launched sessions frequently lack ai-title records and do not appear in the /resume picker, making them impossible to find and resume by name.
- [session-title-persist](session-title-persist/): Custom session titles set via /rename are lost when Claude Code exits abnormally because titles are only written to the stat-log index during normal shutdown.
- [thinking-block-repair](thinking-block-repair/): Extended thinking sessions crash with API 400 errors when conversation history replay strips reasoning_content from prior assistant messages containing tool calls.
- [token-expiry-statusline](token-expiry-statusline/): OAuth session tokens expire silently during active work, killing all running agents mid-execution with no prior warning.
- [work-checkpoint-hook](work-checkpoint-hook/): Context compression causes complete memory loss of recent tool calls, making Claude forget completed file operations and attempt to redo entire batches of work.
- [workcenter](workcenter/): K8s Claude Code Agent Dashboard