williamblair333/Uncle-J-s-Refinery
Turns AI sessions into compounding work — every session more correct, cheaper, and smarter than the last. Right > Cheap-in-total > Inventive > Local. Retrieval-first MCP stack for Claude Code, built on j.gravelle's tools.
stack: Python
ARCHETYPE
Automator
Hooks on every lifecycle event: format, lint, notify, log.
CONTEXT TAX · EVERY TURN
up to ~23.6k tokens
Claude Code loads MCP tools on demand, so the real cost is usually lower.
Context hog · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 18/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit williamblair333/Uncle-J-s-Refinery/.claude ./rig-uncle-j-s-refinery # inspect, then merge into .claude/ MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.
$ npx degit williamblair333/Uncle-J-s-Refinery/features/dreaming/skills/dream-synthesizer .claude/skills/dream-synthesizer $ npx degit williamblair333/Uncle-J-s-Refinery/features/gemini-integration/skills/gemini-auto-skill .claude/skills/gemini-auto-skill
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "[ -f /opt/proj/Uncle-J-s-Refinery/scripts/commit-doc-guard.sh ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/commit-doc-guard.sh"
}
]
},
{
"matcher": "mcp__.*",
"hooks": [
{
"type": "command",
"command": "python3 -c \"import json,sys,datetime,os; d=json.load(sys.stdin); p=os.path.expanduser('~/.claude/state/mcp-tool-log.txt'); os.makedirs(os.path.dirname(p),exist_ok=True); open(p,'a').write('[{}] {}\\n'.format(datetime.datetime.now().strftime("
}
]
}
]
}
} MCP servers (5)
| server | source | est. tokens |
|---|---|---|
| jcodemunch env: CHROMA_API_IMPL | local / custom | 2.5k |
| jdatamunch env: CHROMA_API_IMPL | local / custom | 2.5k |
| jdocmunch env: CHROMA_API_IMPL | local / custom | 2.5k |
| Serena | local / custom | 8.0k |
| duckdb | local / custom | 2.5k |
Skills (2)
Hooks (10)
| event | matcher | runs |
|---|---|---|
| PostToolUse | Write|Edit | [[ "$(git rev-parse --show-toplevel 2>/dev/null)" == "/opt/proj/Uncle-J-s-Refinery" ]] || exit 0; git add -u 2>/dev/null; git diff --cached --quiet && exit 0; git commit -m "chk: $(date +%H:%M:%S)" -q 2>/dev/null || true |
| PreToolUse | Bash | [ -f /opt/proj/Uncle-J-s-Refinery/scripts/commit-doc-guard.sh ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/commit-doc-guard.sh |
| PreToolUse | mcp__.* | python3 -c "import json,sys,datetime,os; d=json.load(sys.stdin); p=os.path.expanduser('~/.claude/state/mcp-tool-log.txt'); os.makedirs(os.path.dirname(p),exist_ok=True); open(p,'a').write('[{}] {}\n'.format(datetime.datetime.now().strftime( |
| Stop | * | [ -d /opt/proj/Uncle-J-s-Refinery ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/session-notify.sh # uncle-j-session-notify |
| Stop | * | [ -d /opt/proj/Uncle-J-s-Refinery ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/skill-suggest.sh # uncle-j-auto-skill |
| Stop | * | [ -d /opt/proj/Uncle-J-s-Refinery ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/skill-link.sh unlink # uncle-j-skill-manager-stop |
| Stop | * | [ -d /opt/proj/Uncle-J-s-Refinery ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/memweave/sync_memory.sh '' 15 >> /opt/proj/Uncle-J-s-Refinery/state/memweave-sync.log 2>&1 # uncle-j-memweave-sync |
| SessionStart | * | [ -d /opt/proj/Uncle-J-s-Refinery ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/skill-link.sh link # uncle-j-skill-manager-session |
| SessionStart | * | [ -d /opt/proj/Uncle-J-s-Refinery ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/review-check.sh 2>/dev/null || true |
| SessionStart | * | [ -d /opt/proj/Uncle-J-s-Refinery ] || exit 0; bash /opt/proj/Uncle-J-s-Refinery/scripts/session-start-autofix.sh |
Plugins (3)
superpowers@claude-plugins-officialunderstand-anything@understand-anythingralph-loop@claude-code-plugins
Permissions
deny (0)
—
ask (0)
—
allow (25)
mcp__jcodemunch__plan_turn
mcp__jcodemunch__resolve_repo
mcp__jcodemunch__suggest_queries
mcp__jcodemunch__search_symbols
mcp__jcodemunch__search_text
mcp__jcodemunch__search_columns
mcp__jcodemunch__get_file_outline
mcp__jcodemunch__get_symbol_source
mcp__jcodemunch__get_context_bundle
mcp__jcodemunch__get_file_content
mcp__jcodemunch__get_repo_outline
mcp__jcodemunch__get_file_tree
mcp__jcodemunch__find_importers
mcp__jcodemunch__find_references
mcp__jcodemunch__check_references
mcp__jcodemunch__get_dependency_graph
mcp__jcodemunch__get_blast_radius
mcp__jcodemunch__get_changed_symbols
mcp__jcodemunch__find_dead_code
mcp__jcodemunch__get_class_hierarchy
mcp__jcodemunch__get_session_context
mcp__jcodemunch__index_file
mcp__jcodemunch__list_repos
mcp__jcodemunch__register_edit
Bash(crontab -l)
Similar rigs
eyaltoledano/claude-task-master
An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
Automator 64.3k tok · · Q3
cocoindex-io/cocoindex
Incremental engine for long horizon agents 🌟 Star if you like it!
Automator 7.3k tok · · Q18
FailproofAI/failproofai
Observability and enforcement for AI agent harnesses. Capture every run and runtime reliability with policy enforcement.
Automator 22.9k tok · · Q48
caliber-ai-org/ai-setup
Continuously sync your AI setups with one command. Codebase tailor suited agent skills, MCPs and config files for Claude Code, Cursor, and Codex.
Automator 3.2k tok · · Q11