{"id":48833601,"url":"https://github.com/battam1111/myco","last_synced_at":"2026-04-27T23:00:38.715Z","repository":{"id":351078998,"uuid":"1205069694","full_name":"Battam1111/Myco","owner":"Battam1111","description":"Self-evolving cognitive organism for AI agents — eternal devouring, eternal evolution.","archived":false,"fork":false,"pushed_at":"2026-04-22T17:43:50.000Z","size":11057,"stargazers_count":53,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-22T18:38:58.920Z","etag":null,"topics":["agent-memory","ai-agents","ai-infrastructure","autonomous-agents","biomimetics","claude","claude-code","codex","cognitive-substrate","cursor","knowledge-management","llm-memory","llm-tools","long-term-memory","mcp","mycelium","python","self-evolving","substrate","vscode"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/myco/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Battam1111.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-08T15:52:05.000Z","updated_at":"2026-04-22T17:44:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Battam1111/Myco","commit_stats":null,"previous_names":["battam1111/myco"],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/Battam1111/Myco","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Battam1111%2FMyco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Battam1111%2FMyco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Battam1111%2FMyco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Battam1111%2FMyco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Battam1111","download_url":"https://codeload.github.com/Battam1111/Myco/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Battam1111%2FMyco/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32358509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-memory","ai-agents","ai-infrastructure","autonomous-agents","biomimetics","claude","claude-code","codex","cognitive-substrate","cursor","knowledge-management","llm-memory","llm-tools","long-term-memory","mcp","mycelium","python","self-evolving","substrate","vscode"],"created_at":"2026-04-14T22:02:42.832Z","updated_at":"2026-04-27T23:00:38.708Z","avatar_url":"https://github.com/Battam1111.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/Battam1111/Myco\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/Battam1111/Myco/main/assets/logo_light_512.png\" width=\"160\" alt=\"Myco\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eMyco\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cb\u003eDevour everything. Evolve forever. You just talk.\u003c/b\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/myco/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/myco?style=flat\u0026cache_seconds=0\" alt=\"PyPI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Python-3.10+-blue?style=flat\" alt=\"Python\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-green?style=flat\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Battam1111/Myco\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/Battam1111/Myco?style=flat\" alt=\"Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://glama.ai/mcp/servers/Battam1111/Myco\"\u003e\u003cimg src=\"https://glama.ai/mcp/servers/Battam1111/Myco/badges/score.svg\" alt=\"Glama score\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://glama.ai/mcp/servers/Battam1111/Myco\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Try_it_live_on-Glama-8b5cf6?style=for-the-badge\" alt=\"Try it live on Glama\" height=\"36\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eClaude\u0026nbsp;Code\u0026nbsp; \u003ccode\u003e/plugin install myco@myco\u003c/code\u003e \u0026nbsp;·\u0026nbsp; Claude\u0026nbsp;Desktop\u0026nbsp; \u003ccode\u003emyco-install host cowork\u003c/code\u003e \u0026nbsp;·\u0026nbsp; Any\u0026nbsp;MCP\u0026nbsp;host\u0026nbsp; \u003ccode\u003epip install 'myco[mcp]'\u003c/code\u003e\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#what-it-is\"\u003eWhat it is\u003c/a\u003e · \u003ca href=\"#how-it-lives\"\u003eHow it lives\u003c/a\u003e · \u003ca href=\"#quick-start\"\u003eQuick start\u003c/a\u003e · \u003ca href=\"#the-twenty-verbs\"\u003eVerbs\u003c/a\u003e · \u003ca href=\"#self-validation\"\u003eSelf-validation\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eLanguages:\u003c/b\u003e English · \u003ca href=\"README_zh.md\"\u003e中文\u003c/a\u003e · \u003ca href=\"README_ja.md\"\u003e日本語\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nLangChain. LangGraph. CrewAI. DSPy. Claude Code skills. OpenHands. OpenClaw. Every few months the next framework drops and you migrate again.\n\nYour notes rot too. The API you read three weeks back has changed. The doc you wrote last year is wrong now. Your AI does not even remember last week's decisions. Every new conversation starts from zero.\n\n\u003cbr\u003e\n\nNow imagine one living substrate. It ingests the frameworks, the papers, the APIs, the codebases, the datasets, the decisions, the frictions. It keeps them connected in a graph the agent actually reads. It catches its own drift. It reshapes itself when your work outgrows its old form. For six months. For six years. No migration.\n\n\u003ch3 align=\"center\"\u003eThis is Myco.\u003c/h3\u003e\n\n---\n\n## What it is\n\nMyco is a living cognitive substrate for your AI agent.\n\nEverything the agent reads or writes, every piece of code and every paper and every decision and every friction, lives on your filesystem as plain markdown + YAML. Files cross-reference each other by name, forming a graph the agent actually reads. The agent eats raw material, digests it into integrated knowledge, immune-checks its own work against drift, propagates learning across your projects, and when the shape of the substrate no longer fits the shape of the work, reshapes the substrate itself. The kernel that runs all of this *is itself a substrate*, editable by default, maintained by the same agent that uses it.\n\nNot a framework. Not a vector database. Not a managed service. A living filesystem for an agent you talk to.\n\nThe idea is older than the implementation. What changed is the agent. Today's models are finally capable of keeping their own tooling alive. Every earlier attempt at a self-maintaining knowledge system died in the same place, where the human in the loop could no longer keep up. Myco puts the loop inside the agent. Every surface, every verb, every rule assumes the maintainer is an agent, so the human in the loop is no longer load-bearing.\n\n## How it lives\n\nYou speak. The agent listens. Between your turns, Myco runs a metabolism.\n\n- **Ingestion.** `hunger` asks what is missing. `eat` absorbs whatever you point at, whether a path, a URL, or a paragraph. `sense` and `forage` scan what is already here. `excrete` safely removes a raw note captured by mistake, moving it to an audit tombstone instead of silently deleting. `intake` (v0.6.0) bulk-ingests a whole directory, composing forage + eat with strict-mode failure visibility.\n- **Digestion.** `assimilate` cooks raw notes into integrated knowledge. `digest` promotes a single note. `sporulate` concentrates integrated notes into a dispersible proposal.\n- **Circulation.** `traverse` walks the graph and reports on its connectedness. `propagate` publishes learning to a downstream substrate.\n- **Homeostasis.** `immune` runs a 25-dimension lint against the seven hard rules. `senesce` winds down each session cleanly.\n- **Evolution.** When the substrate's shape no longer fits the work, whether a canon field is missing, a new lint dimension is needed, or a verb must change, `fruit` drafts a three-round craft proposal, `winnow` gates its shape, and `molt` ships the contract bump.\n\nTwenty verbs, one manifest, two faces: a CLI for you to observe, an MCP server for the agent to drive. You memorize nothing. The agent drives.\n\n## Five principles\n\n- **Only for the agent.** Every surface, every message, every verb shape is primary material for the agent. Not documentation for a human reader.\n- **Devour everything.** No filter on intake. Missing a signal costs more than eating one too many.\n- **Self-evolving shape.** Canon, lint dimensions, verbs, the contract itself, all of it mutable, all of it changed through a single governed craft loop.\n- **Nothing is final.** `integrated` is a state, not an endpoint. Today's conclusion is tomorrow's raw material.\n- **Mycelium network.** Every node links to every other node by traversal. Orphans are dead tissue.\n\n## The kernel IS a substrate\n\nMyco's own source tree is a substrate. `_canon.yaml` at the root. `MYCO.md` as the agent entry page. `docs/primordia/` holding the three-round craft document that justifies every contract bump. The Python code under `src/myco/` is the innermost ring of its own ecosystem. Not a read-only artifact someone else wrote.\n\nSo the normal install clones the source and runs `pip install -e` on it. The agent that uses Myco is the same agent that maintains Myco. When it needs a new lint dimension, it scaffolds one with `myco ramify`, writes the case with `myco fruit`, gates the shape with `myco winnow`, and ships the bump with `myco molt`. No fork. No waiting PR. No long-lived feature branch. **永恒进化.**\n\nPyPI exists for bootstrap and for library embedding. It is not the normal install path.\n\n## Quick start\n\n```bash\npipx run --spec 'myco[mcp]' myco-install fresh ~/myco\n```\n\nThis clones the repository to `~/myco`, runs `pip install -e` on it, and leaves you with a writable kernel. Then germinate a substrate inside any project:\n\n```bash\ncd your-project\nmyco germinate . --substrate-id your-project\n```\n\nHook Myco into your agent host in one command:\n\n- **Claude Code.** Run `/plugin marketplace add Battam1111/Myco`, then `/plugin install myco@myco`.\n- **Claude Desktop / Cowork.** Run `myco-install host cowork` to write the MCP entry, then download [`myco-\u003cver\u003e.plugin`](https://github.com/Battam1111/Myco/releases/latest) and drag it into Claude Desktop → Settings → Plugins → Upload. Claude Desktop uploads it to your private Cowork marketplace and every subsequent session auto-installs the `myco-substrate` onboarding skill.\n- **Any other MCP host.** Run `myco-install host \u003ccursor | windsurf | zed | vscode | openclaw | claude-desktop | gemini-cli | codex-cli | goose\u003e`, or pass `--all-hosts` to auto-detect every host on this machine.\n- **Via the official MCP Registry.** Use the namespace [`io.github.Battam1111/myco`](https://registry.modelcontextprotocol.io/v0/servers?search=Battam1111) for clients that auto-resolve it.\n\nPer-host snippets for the nine hosts with divergent schemas, Python-framework adapters (LangChain, CrewAI, DSPy, Smolagents, Agno, PraisonAI, MS Agent Framework, Claude Agent SDK), and library-embedding examples all live in [`INSTALL.md`](docs/INSTALL.md).\n\n## The twenty verbs\n\nSix subsystems. Every name is a fungal-biology term whose meaning tracks its action.\n\n- **Germination.** `germinate` starts a fresh substrate.\n- **Ingestion.** `hunger` (what is missing?), `eat` (absorb raw material), `sense` (keyword search), `forage` (scan ingestible paths), `excrete` (safely delete a raw note with an audit tombstone), `intake` (bulk-ingest a directory; v0.6.0).\n- **Digestion.** `assimilate` (raw to integrated, in bulk), `digest` (promote a single note), `sporulate` (integrated to dispersible proposal).\n- **Circulation.** `traverse` (walk the graph), `propagate` (publish to a downstream substrate).\n- **Homeostasis.** `immune` (25-dimension lint; `--fix` repairs mechanically where it can).\n- **Cycle.** `senesce` (session dormancy), `fruit` (three-round craft), `winnow` (gate the craft's shape), `molt` (ship the contract bump), `ramify` (scaffold a new dimension, verb, or adapter), `graft` (manage substrate-local plugins), `brief` (human-facing state rollup).\n\nEvery verb lives in [`src/myco/surface/manifest.yaml`](src/myco/surface/manifest.yaml). The CLI (`myco VERB`) and the MCP tool surface both derive from that manifest mechanically. One source of truth for both faces. A downstream substrate can `ramify` its own dimensions or verbs into `.myco/plugins/` without ever forking Myco.\n\n## Self-validation\n\nMyco does not trust its agent to remember the contract. It enforces it.\n\n- **25 lint dimensions** across four categories: *mechanical* (canon invariants, write-surface, LLM-boundary), *shipped* (package and canon version parity), *metabolic* (raw backlog, stale integrated notes), *semantic* (graph connectedness, orphan detection). `myco immune --fix` repairs mechanically where it can.\n- **Seven hard rules (R1 through R7)** govern every session: boot ritual, session-end, sense-before-assert, eat-on-friction, cross-reference-on-creation, write-surface discipline, top-down layering. Full contract at [`L1_CONTRACT/protocol.md`](docs/architecture/L1_CONTRACT/protocol.md).\n- **Pulse sidecar.** Every MCP tool response carries a `substrate_pulse` echoing the current contract version and a rule hint that escalates (R1, then R3, then on through the session) as the session progresses. A server-side push. The agent cannot accidentally forget.\n- **Write-surface enforcement.** Any write outside `_canon.yaml::system.write_surface.allowed` is refused with `WriteSurfaceViolation`. Discipline as a mechanism, not as a request.\n\nZero host-side configuration. R1 through R7 ride inside the MCP server itself, so every client (Claude Code, Cursor, Windsurf, Zed, Codex, Gemini, Continue, Claude Desktop, OpenClaw, OpenHands) gets the same contract on boot.\n\n## Integrations\n\n- **Claude Code.** Official plugin wires MCP, hooks, and slash skills in one command. Or drop `.claude/` in by hand.\n- **Cowork (Claude Desktop local-agent-mode).** Two steps: (1) `myco-install host cowork` writes the MCP server entry; (2) drag the `.plugin` bundle from [GitHub releases](https://github.com/Battam1111/Myco/releases/latest) into Claude Desktop's plugin upload. Claude Desktop uploads it to your private Cowork marketplace, and every session auto-installs the `myco-substrate` onboarding skill so the agent follows R1 through R7 the moment it sees `_canon.yaml`. Cowork does not expose hooks and does not read local plugin dirs, so drag-and-drop is the only persistent path. See [`INSTALL.md`](docs/INSTALL.md) for the full rationale.\n- **Any MCP host.** Ten are automated via `myco-install`. Another nine have per-host snippets in [`INSTALL.md`](docs/INSTALL.md). Any other client can still run `mcp-server-myco` over stdio directly.\n- **Python agent frameworks.** LangChain, CrewAI, DSPy, Smolagents, Agno, PraisonAI, MS Agent Framework, and Claude Agent SDK all consume Myco via `StdioServerParameters(command=\"mcp-server-myco\")`.\n- **Downstream substrates.** `myco propagate` publishes. Adapters live in `myco.boundary.host_integration` (v0.6.0; was `myco.symbionts` pre-v0.6.0).\n\n## Learn more\n\n[`L0_VISION.md`](docs/architecture/L0_VISION.md) · [`L1_CONTRACT/`](docs/architecture/L1_CONTRACT/) · [`L2_DOCTRINE/`](docs/architecture/L2_DOCTRINE/) · [`INSTALL.md`](docs/INSTALL.md) · [`CONTRIBUTING.md`](CONTRIBUTING.md) · [Issues](https://github.com/Battam1111/Myco/issues)\n\nArchitectural changes land as dated craft documents under [`docs/primordia/`](docs/primordia/). Every release is governed by a three-round debate, then a `molt`, then an auto-published fan-out to PyPI, the MCP Registry, and the GitHub release.\n\nMIT · [`LICENSE`](LICENSE) · [PyPI](https://pypi.org/project/myco/) · [Releases](https://github.com/Battam1111/Myco/releases)\n\n\u003c!-- mcp-name: io.github.Battam1111/myco --\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbattam1111%2Fmyco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbattam1111%2Fmyco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbattam1111%2Fmyco/lists"}