Skip to content

goondocks-co/myco

Repository files navigation

Myco

The connected intelligence layer for agents and AI-assisted teams

CI Release Version License Node 22+ Claude | Cursor | VS Code

# Install the plugin
claude plugin add myco

Then in Claude Code:

> /myco-init

The agent initializes your vault, configures capture hooks, and starts building your intelligence graph.

What is Myco?

Myco captures everything your AI agents do — sessions, decisions, plans, discoveries — and connects them into a searchable intelligence graph stored as an Obsidian vault. Named after mycorrhizal networks, the underground fungal systems that connect trees in a forest, Myco is the invisible network linking your agents and team members, sharing intelligence beneath the surface.

For agents — MCP tools let any agent runtime search, recall, and build on your team's accumulated knowledge.

myco_search("how did we handle auth?")  → semantically matched sessions, decisions, and linked context
myco_recall("migration plan")           → full decision history with session lineage
myco_remember(observation)              → persist a discovery for the team

For humans — open the vault in Obsidian and browse the intelligence graph visually. Sessions link to plans, plans link to decisions, decisions link to memories. It's all Markdown with backlinks — your team's connected knowledge, navigable and searchable.

For teams — the vault is a Git-friendly directory of Markdown files. Share it through your existing Git workflow.

How it works

Agent sessions → Plugin hooks + Background daemon → Markdown vault
                                                          ↓
                                               Obsidian graph (humans)
                                               MCP tools (agents)
  • Capture — Plugin hooks record user prompts and agent responses as they happen, building session transcripts in the vault
  • Detect — A lightweight background daemon watches for artifacts — plans, specs, designs, decision records — whether generated by plan mode, Superpowers, or any other tool. These are extracted and linked as first-class vault entries.
  • Connect — Obsidian backlinks and metadata create a navigable graph: sessions → plans → memories → decisions
  • Index — Vector embeddings enable semantic search across the vault. Agents don't just match keywords — they find conceptually related sessions, decisions, and context. The index is fully rebuildable from the Markdown source of truth.
  • Serve — An MCP server exposes the intelligence to Claude Code, Cursor, GitHub, or any MCP-compatible runtime
  • Browse — Open the vault in Obsidian to visualize the graph, search, and explore your team's knowledge

Contributing

Contributions welcome. Please open an issue to discuss before submitting a PR.

License

MIT

About

Myco captures everything your AI agents do - sessions, decisions, plans, discoveries - and connects them into a searchable intelligence graph stored as an Obsidian vault.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages