{"id":47283264,"url":"https://github.com/goondocks-co/myco","last_synced_at":"2026-06-12T02:01:13.816Z","repository":{"id":344644214,"uuid":"1182412020","full_name":"goondocks-co/myco","owner":"goondocks-co","description":"Myco is the nervous system for AI-assisted software teams. Works automatically alongside the coding agents, subagents, and agent teams you already use","archived":false,"fork":false,"pushed_at":"2026-06-05T22:52:36.000Z","size":23108,"stargazers_count":6,"open_issues_count":5,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-06T00:20:36.900Z","etag":null,"topics":["agentic-ai","agentic-coding","agentic-rag","ai-agents","antigravity","claude-code","codex","cursor","harness-engineering","windsurf"],"latest_commit_sha":null,"homepage":"http://myco.sh/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/goondocks-co.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"goondocks-co","custom":["https://github.com/goondocks-co/myco/blob/main/FUNDING.md"]}},"created_at":"2026-03-15T13:42:49.000Z","updated_at":"2026-06-05T22:50:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/goondocks-co/myco","commit_stats":null,"previous_names":["goondocks-co/myco"],"tags_count":179,"template":false,"template_full_name":null,"purl":"pkg:github/goondocks-co/myco","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goondocks-co%2Fmyco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goondocks-co%2Fmyco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goondocks-co%2Fmyco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goondocks-co%2Fmyco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goondocks-co","download_url":"https://codeload.github.com/goondocks-co/myco/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goondocks-co%2Fmyco/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34225351,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agentic-ai","agentic-coding","agentic-rag","ai-agents","antigravity","claude-code","codex","cursor","harness-engineering","windsurf"],"created_at":"2026-03-16T03:06:19.072Z","updated_at":"2026-06-12T02:01:13.802Z","avatar_url":"https://github.com/goondocks-co.png","language":"TypeScript","funding_links":["https://github.com/sponsors/goondocks-co","https://github.com/goondocks-co/myco/blob/main/FUNDING.md"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/myco-hero-wide.jpg\" alt=\"Myco\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eThe nervous system for AI-assisted software teams\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/goondocks-co/myco/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/goondocks-co/myco/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/goondocks-co/myco/actions/workflows/publish.yml\"\u003e\u003cimg src=\"https://github.com/goondocks-co/myco/actions/workflows/publish.yml/badge.svg\" alt=\"Release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@goondocks/myco\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@goondocks/myco?label=npm\u0026color=22c55e\" alt=\"npm\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/goondocks-co/myco/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/goondocks-co/myco?color=22c55e\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sponsors/goondocks-co\"\u003e\u003cimg src=\"https://img.shields.io/badge/sponsor-GitHub%20Sponsors-22c55e\" alt=\"Sponsor Myco\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/node-%3E%3D22-22c55e\" alt=\"Node 22+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/agents-Claude%20Code%20%7C%20Cursor%20%7C%20Codex%20%7C%20VS%20Code%20%7C%20Antigravity%20%7C%20Windsurf%20%7C%20OpenCode%20%7C%20Pi-22c55e\" alt=\"Claude Code | Cursor | Codex | VS Code | Antigravity | Windsurf | OpenCode | Pi\"\u003e\n\u003c/p\u003e\n\n## What is Myco?\n\nMyco is the nervous system for AI-assisted software teams. It captures what happens across your coding sessions, turns raw memory into durable project knowledge, and routes the right context back to every agent and teammate working in the Grove.\n\nMyco works automatically alongside the coding agents, subagents, and agent teams you already use. It does not replace their reasoning, memory, tools, or native workflows, and it does not lock you into one ecosystem.\n\nInstead, Myco gives them an enhanced nervous system: richer senses, durable project knowledge, contextual recall of decisions and pitfalls, semantic codebase awareness, and learned workflows that compound across sessions and teammates.\n\nNamed after [mycorrhizal networks](https://en.wikipedia.org/wiki/Mycorrhizal_network), Myco is not another coding agent. It is the shared knowledge, signal layer, and coordination system beneath the agents you already use.\n\nThat distinction matters. Basic memory systems preserve snapshots: what happened, when it happened, and what was said. Myco treats memory as living project material. Some observations become obsolete as the code changes; repeated observations become wisdom; hard-won gotchas become reusable guidance. The goal is to preserve the tribal knowledge that used to live in the heads of long-running human teams, so each new coding agent can inherit accumulated context instead of starting cold.\n\nThat knowledge also evolves. Myco is not an ever-growing static archive. It keeps refining what the project knows, what the team has learned, and which workflows are still true. Because Myco lives with the project rather than inside any single coding agent or hosted harness, every connected agent can participate in that evolution without forcing your team into one AI ecosystem.\n\n## What Myco does\n\n- **Captures the work** — sessions, prompts, tool use, plans, screenshots, decisions, trade-offs, and gotchas.\n- **Builds project knowledge** — durable **spores**, wisdom, summaries, digests, graph links, and searchable context.\n- **Evolves what matters** — stale observations can be superseded, repeated lessons become wisdom, and workflows stay current as the code changes.\n- **Routes context to agents** — session briefings, relevant spores, and Canopy file anatomy surface when agents need them.\n- **Maps the codebase** — [Canopy](docs/canopy.md) gives agents semantic awareness of files before they open them.\n- **Learns workflows** — repeated procedures become reviewed [skills](docs/skills.md) that every connected agent can follow.\n- **Shares across teams** — optional [Team Sync](docs/team-sync.md) mirrors each teammate's Grove data through Cloudflare and exposes it to cloud agents through a secure MCP server while local databases remain the source of truth.\n\n## Install\n\nmacOS is the primary supported platform for the current release. Linux and Windows packages are published for early testing, but they are experimental and not yet part of the supported path.\n\n```bash\ncurl -fsSL https://myco.sh/install.sh | sh\nmyco open\n```\n\nThat installs the npm package, starts the local service, connects supported coding agents, and opens the local dashboard. Open any git project in a supported coding agent and Myco auto-registers it into your default Grove when the agent starts working there.\n\nYou can also open the dashboard directly at [http://localhost:20915/](http://localhost:20915/). If your local install reports a different service URL, `myco open` will open the right one.\n\nProvider configuration is optional at install time. Capture and full-text search work immediately; spores, digests, semantic search, Canopy summaries, and skill lifecycle features become active after you configure intelligence and embedding providers in the dashboard.\n\nSee [Quickstart](docs/quickstart.md) for setup details and platform notes.\n\n## Upgrade\n\nExisting users upgrade the main product with npm or from the dashboard Operations page:\n\n```bash\nnpm update -g @goondocks/myco\n```\n\nThe main package includes the local CLI, service, agent connections, MCP server, dashboard, and built-in intelligence pipeline. Upgrading from an older per-project install archives legacy Myco-owned files the next time Myco starts. See [Upgrading Myco](docs/upgrade.md).\n\nOptional operator packages are only needed for infrastructure administration:\n\n- `@goondocks/myco-team` — provision and manage a team's sync Worker (operators only; teammates join from the dashboard)\n- `@goondocks/myco-collective` — deploy and manage a Myco Collective\n\n## How it works\n\n### Capture\n\nSymbionts connect Myco to the agents you already use. They capture session starts, prompts, tool calls, stops, transcripts, and attachments into the Grove vault without replacing the agent's own memory or workflow.\n\n### Intelligence\n\nThe [agent harness](docs/agent-harness.md) runs Myco's background intelligence work. It reads captured sessions, extracts **spores** (decisions, gotchas, discoveries, trade-offs, fixes), generates titles and summaries, links entities into a knowledge graph, and refreshes digest extracts.\n\nWhen Myco finds 3+ semantically similar spores, it synthesizes them into a **wisdom** spore — a higher-order observation that captures the pattern across sessions. Individual observations become institutional knowledge.\n\nAs the project changes, that knowledge keeps moving. New sessions can reinforce a pattern, replace an outdated assumption, or expose a workflow that should become shared practice.\n\nEvery task can use a different LLM provider. Run title generation on a fast local model via Ollama, extraction on Claude, and consolidation on a larger local model via LM Studio. Configure providers from the [dashboard](#dashboard).\n\nSee the [Intelligence Pipeline docs](docs/agent-harness.md) for the task catalog, provider configuration, and scheduling.\n\n### Digest\n\nThe digest synthesizes accumulated knowledge into tiered **extracts** — pre-computed context at different depths:\n\n| Tier | Purpose |\n|------|---------|\n| **1,500 tokens** | Executive briefing — what this project is, what's active, what to avoid |\n| **5,000 tokens** | Deep onboarding — trade-offs, patterns, team dynamics |\n| **10,000 tokens** | Institutional knowledge — full thread history and design tensions |\n\nExtracts refresh in the background as new knowledge arrives. When the project goes quiet, refresh slows; new sessions wake it back up.\n\n### Search\n\nEvery record is indexed for both keyword search and semantic similarity. Use [Ollama](https://ollama.com) locally for embeddings, or [OpenRouter](https://openrouter.ai) / [OpenAI](https://platform.openai.com) in the cloud. The index is fully rebuildable from the database.\n\n### Canopy — codebase awareness\n\nMyco keeps a fresh per-file index of your project — exports, imports, top comment, optional one-line summary — and hands the agent that anatomy before it opens a file. A single `myco_cortex` call with `op: \"canopy_map\"` returns the project's architectural overview, so a new agent can orient in one tool call instead of a dozen searches. Manage it from the dashboard's **Cortex** tab. See the [Canopy docs](docs/canopy.md).\n\n### Context injection\n\nMyco routes project context to agents automatically:\n\n- **Session start** — a project briefing gives the agent pre-computed project understanding before it asks a single question.\n- **Per-prompt** — relevant spores are retrieved after user prompts, providing targeted context for the task at hand.\n- **Pre-read** — Canopy file anatomy appears before reads so agents can choose the right file faster.\n\nAgents can still use their own memory and tools. Myco adds shared project context without taking those systems over.\n\n### Dashboard\n\nA local web dashboard provides configuration and operations management. Manage Groves and projects, configure providers, approve skill candidates, trigger intelligence and digest cycles, monitor service health, and view live logs.\n\nUse the [Grove Management guide](docs/groves.md) to decide when to create additional Groves, move or archive projects, and toggle per-project capabilities such as Cortex, Canopy, Skills, and Vault Evolution.\n\n### Symbionts\n\nMyco integrates with coding agents through **symbionts**. Each symbiont connects Myco to an agent's native context, tools, skills, and permissions while preserving that agent's own workflow.\n\nSupported symbionts include Claude Code, Cursor, Codex, Copilot, Antigravity, Windsurf, OpenCode, and Pi. See the [Symbiont docs](docs/symbionts.md) for agent-specific details.\n\n### Team sync\n\nShare knowledge across machines and teammates. One person provisions the team's cloud infrastructure once; everyone else joins from the dashboard with nothing extra to install:\n\n```bash\nnpm install -g @goondocks/myco-team wrangler \u0026\u0026 wrangler login\nmyco-team install --name \"Acme Core\"   # deploys the team Worker; prints a Worker URL + Team key\n```\n\nShare the Worker URL and Team key with teammates. Each teammate opens the **Team** page in their dashboard, joins the team with those two values, and assigns the projects they want to sync — no `myco-team` package needed. From then on, each assigned project's knowledge syncs automatically: new spores, session summaries, plans, and graph edges become available to the team in the background, and search returns both local and team knowledge.\n\nLocal Grove databases remain the source of truth. The cloud store is a queryable mirror of connected teammates' Grove data, and each record carries a machine identity for attribution.\n\nRuns on the Cloudflare free tier. See the [Team Sync docs](docs/team-sync.md) for the full guide.\n\n### Collective\n\nSearch across projects and manage shared settings by connecting multiple team workers to one Myco Collective.\n\nInstall it only if you want the cross-project admin layer:\n\n```bash\nnpm install -g @goondocks/myco-collective\nmyco-collective install\n```\n\nThe Collective gives you a worker-hosted admin UI for connected projects, shared settings, and cross-project search. See the [Collective guide](docs/collective.md).\n\n### Cloud MCP Server\n\nTeam Sync also deploys a read-only **Cloud MCP server** on the same Worker — a secure Streamable HTTP endpoint that exposes synced Grove intelligence to cloud agents like Anthropic Managed Agents, OpenAI Workflows, and N8N. Connect any tool that speaks MCP and it gets the same project context your local agents already have. See the [Cloud MCP docs](docs/cloud-mcp.md) for the tool reference and setup.\n\n### Skills — automated curation, not just memory\n\nMemory is table stakes. Myco goes further: it turns accumulated project knowledge into **repeatable workflows** that every agent follows. The intelligence pipeline identifies procedural patterns across sessions — debugging the build, adding API routes, configuring providers, resolving common gotchas — and surfaces them as candidates. You approve what becomes canon, and Myco generates validated SKILL.md files under `.agents/skills/`, symlinked into every agent's native skills directory.\n\nSkills evolve as your code does. When a pattern is abandoned, a new gotcha is discovered, or a workflow shifts, Myco refreshes affected skills — preserving what's still accurate, incorporating what's new, and splitting skills that have grown too broad. See the [Skills docs](docs/skills.md) for the full lifecycle.\n\n### Backup \u0026 restore\n\nBackups and restores are Grove-scoped. Local backups run automatically during idle periods, and destructive project deletion creates a fresh Grove backup first when backups are enabled. Configure a custom backup directory from the Operations page. Restore preserves existing records and avoids importing duplicates.\n\n## Health check\n\n```bash\nmyco doctor\n```\n\nVerifies your local Myco install, Grove data, provider setup, connected agents, service status, and dashboard access. Use `--fix` to auto-repair fixable issues.\n\n## Uninstall\n\n```bash\nmyco remove           # removes Myco's contributions from every agent's global config\nmyco remove --purge   # also removes ~/.myco/ itself\n```\n\nRemoval preserves any user-pre-existing keys in agent config files (e.g. a Codex `[features].hooks` entry you added yourself stays put).\n\n## Contributing\n\nContributions welcome. See the [Contributing Guide](CONTRIBUTING.md) for development setup, and the [Lifecycle docs](docs/lifecycle.md) for architecture details. Please open an issue to discuss before submitting a PR.\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoondocks-co%2Fmyco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoondocks-co%2Fmyco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoondocks-co%2Fmyco/lists"}