plugins, hooks, agents, and a comprehensive guide for claude code. tested across 4,000+ sessions.
by ani potts
installable via claude plugin add:
| plugin | description |
|---|---|
| miner | mines every session to sqlite with FTS5 search. tracks costs, tokens, cache efficiency. four power features: echo (solution recall), scar (mistake memory), gauge (model advisor), imprint (stack recall) |
| handoff | saves context before compression hits — never lose your plan |
| broadcast | async notifications when claude ships something |
claude plugin add anipotts/miner
standalone scripts. copy to ~/.claude/hooks/ and wire up in settings:
| hook | event | description |
|---|---|---|
| safety-guard | PreToolUse | blocks force push, rm -rf /, DROP TABLE |
| context-save | PreCompact | saves context to markdown before compression |
| panopticon | PostToolUse | logs every tool action to sqlite |
| knowledge-builder | PostToolUse | builds a codebase knowledge graph as claude explores |
| notify | Notification | routes to macOS, Slack, Pushover, ntfy |
cp hooks/safety-guard.sh ~/.claude/hooks/
drop into .claude/skills/ or .claude/commands/:
| name | description |
|---|---|
| /sift | search and analyze session history — costs, tools, patterns, FTS5 search |
| /ledger | quick usage dashboard — tokens, costs, tools, projects |
| /improve | CLAUDE.md self-improvement from git history |
| /ship | stage, commit, push, open a PR |
| /sweep | find and clean dead code |
| /quicktest | run tests for what you're working on |
| /stats | project health — LOC, git activity, test coverage |
| /deps | dependency updates and security audit |
drop into .claude/agents/:
| agent | description |
|---|---|
| analyst | deep session analysis — free-form SQL against miner.db |
| explorer | parallel worktree exploration |
| guardian | persistent daemon / file watcher |
| code-sweeper | dead code, unused imports, stale TODOs |
| pr-narrator | writes PR descriptions from your diff |
| dep-checker | outdated deps, security advisories |
| test-writer | edge case tests the original dev missed |
| vibe-check | quick architecture review |
docs/guide.md — a three-tier progressive guide to claude code:
- beginner — install, CLAUDE.md, permissions, settings
- intermediate — extensibility stack, hooks, plugins, subagents, MCP
- advanced — miner, headless CLI tools, self-improvement loops, daemons, github actions
- hooks guide — every hook event, tested examples, advanced patterns
- plugin creation — plugin.json spec, full walkthrough, marketplace publishing
- subagent patterns — parallel research, scout pattern, worktree isolation
- mcp servers — playwright, context7, building your own
- cli tools — headless
claude -pas a shell function factory - automation — daemons, cron, file watchers, guardian agent
MIT