plugins, hooks, slash commands, agents, and docs for claude code. everything is copy-paste ready.
flagship: mine — mines every session to sqlite. costs, search, patterns. claude plugin add anipotts/mine
the flagship. mines every claude code session to sqlite -- tracks costs, tokens, cache efficiency, and gives you five power features: search (solution recall), mistakes (error memory), burn (cost anomaly detection), hotspots (file edit analysis), and loops (repeated pattern detection).
claude plugin add anipotts/mineonce installed, use /mine in any session to query your usage in plain language:
/mine → dashboard: today's sessions, weekly cost, top tools
/mine how much have i spent → cost breakdown by project, model, time period
/mine value → API inference value at published rates
/mine search "websocket" → full-text search across all conversations
/mine what's my cache hit rate → cache efficiency analysis
installable via claude plugin add:
| plugin | description |
|---|---|
| mine | mines sessions to sqlite with FTS5 search, cost tracking, and five power features |
| handoff | saves context before compression -- never lose your plan |
| broadcast | async notifications when claude ships something |
these live in .claude/commands/ and are auto-discovered by claude code. clone this repo and they're available in any session started from within it.
| command | description |
|---|---|
/mine |
query your usage data in plain language -- costs, sessions, search, tools, projects |
/improve |
analyze recent sessions and git history to propose CLAUDE.md improvements |
/ship |
stage, commit, push, and open a PR in one shot |
/sweep |
find and clean dead code, unused imports, stale TODOs |
/quicktest |
find and run the test file for whatever you're working on |
/stats |
project health -- LOC, git activity, test coverage |
/deps |
dependency updates and security audit (node, python, rust, go) |
deprecated commands (/sift, /ledger, /value, /miner) still work but route through /mine now.
these live in .claude/agents/ and are auto-discovered. use them for longer-running, autonomous tasks.
| agent | description |
|---|---|
| analyst | free-form SQL investigator against your mine.db |
| explorer | parallel worktree exploration -- try risky changes safely |
| guardian | daemon that watches your project and proposes fixes |
| code-sweeper | finds dead code, unused imports, stale TODOs |
| pr-narrator | writes PR descriptions from your diff |
| dep-checker | outdated deps, security advisories, priority-sorted |
| test-writer | generates edge case tests you probably missed |
| vibe-check | quick, opinionated architecture review |
standalone scripts you can copy into your own setup. each one is a single file:
| 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 |
to use a hook, copy it and wire it up in your claude code settings:
cp hooks/safety-guard.sh ~/.claude/hooks/then add it to ~/.claude/settings.json under the appropriate hook event. see hooks guide for the full setup.
docs/guide.md is a three-tier progressive guide:
- beginner -- install, CLAUDE.md, permissions, settings
- intermediate -- hooks, plugins, subagents, MCP
- advanced -- mine, headless CLI tools, self-improvement loops, daemons, github actions
reference docs:
- 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
plugins/mine/ mine plugin (installable via marketplace)
plugins/handoff/ handoff plugin
plugins/broadcast/ broadcast plugin
.claude/commands/ slash commands (auto-discovered)
.claude/agents/ agents (auto-discovered)
hooks/ standalone hook scripts
docs/ guides and reference
scripts/ mine.py bulk parser, schema.sql
gifs/ VHS tape files and demo recordings
tips, fixes, and new content welcome -- see CONTRIBUTING.md.
MIT