Mycelium · for Obsidian v1.3.0 · MIT
Architecture Two tiers · one surface For builders

Sovereignty,
and aliveness.

Mycelium ships in two tiers. Filesystem tools give sovereignty and reliability — markdown on disk, available even when Obsidian is closed. CLI tools give aliveness — the AI reaches inside the running app. Everything below ships in v1.3.0; anything still in design is labelled Coming Next.

01 — Tiers

Two tiers. One reaches the disk, one reaches the app.

102 tools, split by what they depend on. The filesystem tier is the dependable substrate; the CLI tier is the living application. If the app is closed, the 74 keep working.

Filesystem tier
74
Sovereignty & reliability — work when Obsidian is closed.
  • Read / write markdown
  • Search · cross-vault search
  • Frontmatter queries
  • Link inspection
  • Section editing
  • Health reports · maintenance
  • Properties · tags · tasks · dailies
Always available
CLI tier
28
Aliveness — inside the running Obsidian app.
  • Command palette
  • Obsidian’s own search engine
  • Bases · templates
  • Version & sync history
  • Recents · hotkeys
  • Plugins · snippets · themes
  • Runtime app APIs
Needs Obsidian 1.12+

Filesystem = sovereignty & reliability.  ·  CLI = aliveness, inside the running Obsidian app.

02 — Operator

Inside Obsidian itself.

When the app is running, the CLI tier becomes a full Obsidian operator — using Obsidian’s own search, your templates, Bases, history and commands.

The power hatch · advanced operators

eval_obsidian runs JavaScript inside Obsidian’s runtime.

It can inspect internal app state, use Obsidian APIs, bridge plugin APIs, and prototype operations that aren’t yet formal tools. This is power that comes with ownership — you own the vault, you choose which tools are exposed, and you can disable advanced tools per deployment.

Deep inspectionAsk the live app what it knows — not only what files contain.
Plugin bridgesExplore APIs exposed by installed plugins.
Custom operationsPrecise runtime work before it deserves a dedicated tool.
Off by defaultEnable eval_obsidian deliberately; disable any tool with OBSIDIAN_DISABLED_TOOLS.
Off unless you turn it on. eval_obsidian is an advanced operator tool — enable it deliberately, and disable any tool with OBSIDIAN_DISABLED_TOOLS. Local ownership means you decide.
03 — Ways in

The AI doesn’t have one search box. It has four ways in.

Different questions need different retrieval paths — and some need to cross vault boundaries. This is the heart of the product story.

01

Keyword & full-text

When you remember a phrase, project name, person, or exact term — even if it could live in several vaults.

always availablesearch_contentsearch_with_context
needs the appvault_search
02

Meaning-based

When you remember the idea, not the words. Optional local embeddings via Ollama make this possible.

requires Ollamasemantic_searchsemantic_search_allget_similar
03

Link reading

When the question lives in relationships: what points here, where does this lead, what’s disconnected? Navigation, not ranking.

read-only graphget_backlinksget_outlinksorphans
04

Structured query

When notes carry properties: status, type, priority, owner, area, date, client, stage — anything you tag.

database-likequery_notesquery_base
04 — Layers

The layers a vault actually has.

A note is a file and an Obsidian identity and structured content and metadata and a set of links. Mycelium exposes the right layer for each operation.

Filesystemdisk
A vault is a folder of markdown on disk. Mycelium does safe path resolution — absolute paths and ../ traversal stay blocked.
Obsidian appbehavior
Opening a folder as a vault gives links, metadata, search, Bases, plugins. Mycelium respects Obsidian concepts, not only raw files.
MCP confignames
Mycelium knows your vaults by configured name, and those exact names are surfaced to the AI — no stale “Platform” / “Helena” example drift.
Contentknowledge
Notes carry headings, sections, paragraphs, lists, tasks, tables, quotes, code blocks and citations. Mycelium can read outlines, search with context, target sections, and retrieve the exact slice of knowledge an AI needs.
Frontmattermetadata
Machine-readable metadata inside notes. Used for filtering, classification and querying where it’s the right authority.
Linksreferences
Same-vault wikilinks and cross-vault obsidian:// URIs. Native wikilinks stay vault-local; cross-vault movement runs through resolver-backed paths and URIs.
Graphread-only
Links expose backlinks, outlinks, orphans, broken links and dead-ends. Today this navigates and audits — it does not rank. Ranking is Coming Next.
05 — Resolver

Resolver-first. Right tool, right order.

A good session starts with get_started: it tells the assistant which vaults exist and which tools fit each job. From there, the resolver ladder gives a recovery path — Obsidian-native resolution before filesystem habits.

01follow_linkVault + note title or wikilink known → resolve identity to file, read it.
02find_note_by_nameTitle is approximate, or the vault is unknown → locate it first.
03search_all_vaultsContent search, when no single note is named → search across vaults.
04read_fileOnly when the exact vault-relative path is genuinely known or required.
Before · dead end
// the agent is simply stuck
{
  "error": "Unknown vault",
  "received": "Research"
}
After · self-correcting
{
  "error": "Unknown vault",
  "closest_matches": ["Research Vault"],
  "next_action": "Retry with vault=
    \"Research Vault\""
}

Same pattern for a missing note: the error suggests follow_link, find_note_by_name and search_content as ordered next steps. The agent reads the hint and tries again — no human correction needed.

06 — Links

Same vault, or across the ecosystem.

Mycelium exposes both native Obsidian wikilinks and cross-vault URI targets, so an agnostic AI client writes links that actually resolve — and cites which vault each came from.

Link syntax · taught in get_startedmarkdown
# Same vault — a wikilink
[[Note Name]]

# Across vaults — an Obsidian URI (vault + file URL-encoded, no .md)
[Kickoff](obsidian://open?vault=Work&file=Projects%2FKickoff)
Coming next · designed, not shipped

The next layer
of Mycelium.

These are designed as future direction. They make a forward-looking story — but none of them is presented as a capability in v1.3.0. What ships today for the graph is read-only: backlinks, outlinks, orphans, broken links, health.

Honest roadmap · never shipped-until-shipped Stratum 05 · Mycelium
07 — Future

Coming next.

Inspiration for where Mycelium goes — not available today.

Designed · not shipped

Graph orientation

Help the AI understand hubs, roots, leaves and structural position inside a vault.

Designed · not shipped

Graph-aware search

Use links and structure to annotate, exclude, or re-rank search results.

Designed · not shipped

Relevance + importance

Combine semantic relevance with structural importance — without pretending it ships today.

Designed · not shipped

Composed vaults

Treat folders from different filesystem locations as one working vault surface.

Designed · not shipped

Memory capsules

Portable, structured memory layers built from vault knowledge.

Designed · not shipped

Two Pillars

The broader future framing behind graph intelligence and composed knowledge spaces.