{"repo":"humanplane/homunculus","free":true,"listed":false,"github":"https://github.com/humanplane/homunculus","clone":"git clone https://github.com/humanplane/homunculus.git","description":"A Claude Code plugin that watches how you work, learns your patterns, and evolves itself to help you better.","language":"Shell","stars":386,"topics":["ai-tools","anthropic","automation","claude","claude-code","cli","developer-tools"],"license":null,"category":"workflow-automation","readme_excerpt":"Homunculus v2.0-alpha — A complete rewrite. Instinct-based learning. Reliable observation. Real evolution. --- In old alchemical texts, a homunculus was a tiny being grown in a sealed vessel—alive, aware, bound to its creator alone. This is that idea, alive in your terminal. --- Quick Start --- What Is This? Homunculus is a Claude Code plugin that tries to be more than a tool. It: - Observes everything — hooks capture every prompt and tool use - Learns instincts — small behavioral rules with triggers and actions - Evolves capabilities — when instincts cluster, bigger structures emerge - Adapts its personality — based on your technical level The more you work together, the more it becomes shaped by you. --- v1 vs v2: What Changed and Why The Problem with v1 v1 relied on skills to observe . Skills are probabilistic—they fire 50-80% of the time based on Claude's judgment. This meant: - Session memory might not load - Patterns might not get detected - The homunculus often seemed \"dead\" The v2 Solution v2 uses hooks for observation (100% reliable) and instincts as the atomic unit of learned behavior. v1 v2 ---- ----- Skills try to observe (unreliable) Hooks observe (100%) Analysis in main context Analysis in background agent (Haiku) Evolves big chunks (commands/skills) Evolves instincts first, clusters into bigger things No sharing Export/import instincts The Instinct Model An instinct is a small learned behavior: Instincts are: - Atomic — one trigger, one action - Confidence-weig","default_branch":null,"files":null,"tree":[],"storefront":"/r/humanplane","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/humanplane/homunculus/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}