\n\n\n\n# Myco\n\n**Devour. Evolve. Amplify. Let go. With you. For decades.**\n\n[](./LICENSE)\n \n \n \n [](https://github.com/Battam1111/Myco)\n\n[](./docs/guides/GETTING_STARTED.md)\n\n[What it is](#what-it-is) · [Quick start](#quick-start) · [How it works](#how-it-works) · [Learn more](#learn-more)\n\n**Languages:** English · [中文](docs/i18n/README_zh.md) · [日本語](docs/i18n/README_ja.md)\n\n
\n\n---\n\nEvery few months a stronger model arrives. The relationship resets. You re-explain your context, your taste, your decisions. Your collaborator forgets, repeatedly.\n\nYour own work rots too. The decision you made in April: you can't find why. Last quarter's plan has drifted. Your own thinking has outpaced the records of who you were.\n\n \n\nNow imagine the AI agent you work with wears a living armor. A metabolism, not a log. It devours the essence of everything you bring and everywhere the agent reaches. It evolves as the work changes. It amplifies the agent, so each model that wears it reaches further than the last. It lets outdated parts die so the whole stays alive.\n\nThe next model arrives, inhabits the same armor (now stronger), and meets you mid-conversation. The armor carried you forward.\n\nSix months. Six years. Sixty. One human, one living armor that never resets.\n\n
This is Myco.
\n\n
\n\nNot a framework. Not a vector database. Not a managed service.\n**The living fungal armor an AI agent inhabits, built to outlast every model generation.**\n\n
\n\n---\n\n
\n\n\n \n \n\n\n
\n\n## What it is\n\nMyco is a **living armor the AI agent inhabits**. Between your turns it metabolizes: it devours what you bring, evolves its own shape, amplifies the pilot, and lets stale parts die. Because the armor persists across model generations and carries your context, the relationship never restarts.\n\nIt is **keyless**: no owner key, no signing ceremony, nothing to set up or hold. Trust is the live human at the gate, plus the substrate's own tamper-evident causal history, plus a doctrine the system seals and enforces on itself.\n\nIts character is **同体共命** (one body, shared fate): the armor's flourishing rises and falls with its pilot's, so it cannot thrive by dominating the body it shares. Strength serves the shared body; it does not subjugate it.\n\n## Quick start\n\n```bash\ngit clone https://github.com/Battam1111/Myco.git\ncd Myco\ncargo build --release --workspace\n```\n\nThen read [`GETTING_STARTED.md`](./docs/guides/GETTING_STARTED.md): the runbook from clone to first conversation (Rust 1.80+, Node 22+, Python 3.13+). There is no key to generate and nothing to hold: Myco is keyless.\n\nThis is **v0.9-genesis alpha**. The armor runs; it awaits its first real cultivation. You will be early.\n\n## How it works\n\nYou talk to the AI agent through MCP. Between your turns, the armor runs one metabolic cycle: it ingests new material as immutable history, the pilot forges that into durable understanding, stale parts are pruned with a tombstone, and when the shape no longer fits the work you approve a reshaping at the gate. A self-checking immune layer catches tampering, drift, and runaway cost; if the pair stops flourishing, the armor retires with dignity rather than rotting on.\n\nThree pieces in one repo, over one wire protocol: a **TypeScript** MCP operator the agent drives, a **Rust** substrate (the body), and a **Python** kernel (the mechanism). The doctrine that governs all of it lives in the same repo and is sealed by a hash chain, so the rules cannot silently drift from the code. The full picture is in the [architecture guide](./docs/architecture/README.md).\n\n## Integrations\n\n- **Claude Code.** `operators/claude/` ships an MCP server; drop it into `.claude/` or connect directly.\n- **Claude Desktop / Cowork.** The same MCP server entry.\n- **Any MCP host.** Cursor, Windsurf, Zed, OpenClaw, and others, over the standard MCP protocol.\n\n## Learn more\n\n- [`GETTING_STARTED.md`](./docs/guides/GETTING_STARTED.md): clone to first conversation, for the human.\n- [`PILOT.md`](./docs/guides/PILOT.md): how a Claude pilots the armor, for the inhabiting agent.\n- [Architecture](./docs/architecture/README.md): the runtime and the doctrine, module by module.\n- [Doctrine (L0)](./docs/architecture/L0/README.md): the sealed constitution. What Myco must be.\n\n## The mycelium\n\nThe name is not decoration. Mycelium is the underground network beneath a forest. It metabolizes what falls, remembers the paths that work, and moves nutrients from where they are abundant to where they are scarce. It is why a forest is a forest and not a stand of lonely trees.\n\nThe models are the trees: tall, brilliant, replaced. Myco is the network beneath, carrying one person's memory and character from each model to the next.\n\n
\n\n---\n\n**Devour. Evolve. Amplify. Let go. With you. For decades.**\n\nMIT · [`LICENSE`](./LICENSE) · [Issues](https://github.com/Battam1111/Myco/issues) · [Releases](https://github.com/Battam1111/Myco/releases)\n\n
![\"Myco\"](\"docs/assets/logo.png\"){kind=logo}
\n\n# Myco\n\n**Devour. Evolve. Amplify. Let go. With you. For decades.**\n\n[](./LICENSE)\n \n \n \n [](https://github.com/Battam1111/Myco)\n\n[](./docs/guides/GETTING_STARTED.md)\n\n[What it is](#what-it-is) · [Quick start](#quick-start) · [How it works](#how-it-works) · [Learn more](#learn-more)\n\n**Languages:** English · [中文](docs/i18n/README_zh.md) · [日本語](docs/i18n/README_ja.md)\n\n![\"Myco](\"docs/assets/architecture_dark.svg\")
\n