homunculus

Homunculus Marketplace

Self-evolving memory system for Claude Code.

Install

/plugin marketplace add littleCareless/homunculus
/plugin install homunculus

What it does

• 🔍 100% behavior capture — Hook-based observation of every tool call
• 🧬 Dual-path pattern extraction — Statistical detectors + LLM semantic analysis
• 📈 Confidence evolution — Re-validated patterns strengthen, unused patterns decay
• 🎯 Semantic deduplication — Jaccard + Union-Find keeps rule count sane
• 🔒 Privacy-first — All data stays local (~/.claude/homunculus/)
• ⚡ Zero-config — Install plugin, restart Claude Code, done

See plugin/README.md for full documentation.

Architecture

[Session] Tool calls
    ↓ Hooks (Pre/PostToolUse)
Layer 1: Observation Engine → observations.jsonl
    ↓ SessionEnd
Layer 2: Instinct Engine (statistical + semantic)
    ↓
instincts/personal/*.md
    ↓ filter confidence ≥ 0.7
~/.claude/rules/auto-evolved.md
    ↓ Claude Code natively loads
Layer 3: Injection → next session starts with learned rules

License

MIT