{"id":48833601,"url":"https://github.com/battam1111/myco","last_synced_at":"2026-04-22T18:01:21.094Z","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-22T04:02:04.000Z","size":10919,"stargazers_count":51,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-22T06:10:30.974Z","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":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-22T04:25:24.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":9,"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":32148180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"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-22T18:01:21.088Z","avatar_url":"https://github.com/Battam1111.png","language":"Python","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\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-eighteen-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 — code, papers, decisions, frictions — lives on your filesystem as markdown + YAML, linked into a mycelial graph. The agent eats raw material, digests it into integrated knowledge, immune-checks against drift, propagates learning across projects, and — when your work outgrows the old shape — reshapes the substrate itself. The kernel that runs all this *is itself a substrate*: editable by default, maintained by the same agent that uses it.\n\nNot a framework. Not a vector DB. Not a managed service. A living filesystem for an agent you talk to.\n\nThis works now, not because the idea is new, but because agents are finally smart enough to maintain the system themselves. Earlier attempts died because humans could not keep up. Myco bakes \"the maintainer is an agent\" into every surface, every verb, every rule.\n\n## How it lives\n\nYou speak. The agent listens. Between your turns, Myco runs a metabolism:\n\n- **Ingestion.** `hunger` asks what's missing. `eat` absorbs whatever you point at — a path, a URL, a paragraph. `sense` and `forage` scan what's already here.\n- **Digestion.** `assimilate` cooks raw notes into integrated knowledge. `sporulate` concentrates integrated notes into a dispersible proposal.\n- **Circulation.** `traverse` walks the mycelial graph for anastomotic health. `propagate` publishes learnings to a downstream substrate.\n- **Homeostasis.** `immune` runs a 25-dimension lint against the seven hard rules. `senesce` gracefully winds down each session.\n- **Evolution.** When the substrate's shape no longer fits — a canon field is missing, a lint dimension is needed, a verb must change — `fruit` drafts a three-round craft proposal, `winnow` gates its shape, `molt` ships the contract bump.\n\nEighteen verbs, one manifest, two faces (a CLI for observation, an MCP server for the agent). You memorize nothing; the agent drives.\n\n## Five principles\n\n- **Only for the agent.** Every surface 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 mutable through a 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 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/` holds the three-round craft doc 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 `pip install -e`s it. The agent that uses Myco is the same agent that maintains Myco; if it needs a new lint dimension, it scaffolds one with `myco ramify`, proposes with `myco fruit`, ships with `myco molt`. No fork. No waiting PR. **永恒进化.**\n\nPyPI exists for bootstrap + library-consumer use — not as the normal install.\n\n## Quick start\n\n```bash\npipx run --spec 'myco[mcp]' myco-install fresh ~/myco\n```\n\nClones the repo to `~/myco`, `pip install -e`s it, leaves you with a writable kernel. Then germinate a substrate for 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** — `/plugin marketplace add Battam1111/Myco`, then `/plugin install myco@myco`.\n- **Claude Desktop / Cowork** — `myco-install host cowork` writes the MCP entry *and* installs the `myco-substrate` onboarding skill into every Cowork workspace.\n- **Any other MCP host** — `myco-install host \u003ccursor | windsurf | zed | vscode | openclaw | claude-desktop | gemini-cli | codex-cli | goose\u003e`, or `--all-hosts` to auto-detect every host on this machine.\n- **Via the official MCP Registry** — [`io.github.Battam1111/myco`](https://registry.modelcontextprotocol.io/v0/servers?search=Battam1111) for clients that auto-resolve namespaces.\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 live in [`INSTALL.md`](docs/INSTALL.md).\n\n## The eighteen 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's missing?), `eat` (absorb raw), `sense` (keyword search), `forage` (scan ingestible paths).\n- **Digestion** — `assimilate` (raw → integrated), `digest` (promote a single note), `sporulate` (integrated → dispersible proposal).\n- **Circulation** — `traverse` (walk the graph), `propagate` (publish downstream).\n- **Homeostasis** — `immune` (25-dimension lint, `--fix` repairs mechanically).\n- **Cycle** — `senesce` (session dormancy), `fruit` (three-round craft), `winnow` (gate the craft), `molt` (ship the contract bump), `ramify` (scaffold new dim / verb / 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 it mechanically — one source of truth for both faces. A downstream substrate can `ramify` its own dimensions or verbs into `.myco/plugins/` without 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 ↔ 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–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 → R3 → …) 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–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 + slash skills in one command. Or drop `.claude/` in by hand.\n- **Cowork (Claude Desktop local-agent-mode).** `myco-install host cowork` installs MCP + the `myco-substrate` onboarding skill so the Cowork agent follows R1-R7 the moment it sees `_canon.yaml`. Cowork doesn't expose hooks, so the boot ritual rides on a skill instead — see [`INSTALL.md`](docs/INSTALL.md) and `.cowork-plugin/README.md` for rationale.\n- **Any MCP host.** Ten automated via `myco-install`; another nine with per-host snippets in [`INSTALL.md`](docs/INSTALL.md); any other client via `mcp-server-myco` over stdio.\n- **Python agent frameworks.** LangChain, CrewAI, DSPy, Smolagents, Agno, PraisonAI, MS Agent Framework, Claude Agent SDK all consume Myco via `StdioServerParameters(command=\"mcp-server-myco\")`.\n- **Downstream substrates.** `myco propagate` publishes; adapters live in `myco.symbionts`.\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 docs 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 + MCP Registry + 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","funding_links":[],"categories":[],"sub_categories":[],"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"}