Skip to main content
Glama

mycelium

Shared toolkit for building agent plugins over personal knowledge sources (documents, notes, and whatever comes next) — extracted out of the OpenClaw plugins for paperless-ngx and Trilium Notes, which had independently grown near-identical semantic search implementations. Those plugins — plus the 1Password secret-provider plugin — now live in this same repo (apps/paperless-ngx, apps/trilium, apps/onepassword), so they can consume the shared packages below as ordinary workspace dependencies instead of a publish-then-consume round trip across separate repos. Each still publishes to npm independently, under its own name.

Three problems, three packages:

Package

Problem it solves

@transmitt0r/mycelium-embed

"I want to use any LLM for embeddings/retrieval, not just one hardcoded provider." Pluggable client for any OpenAI-compatible endpoint (OpenAI, OpenRouter, Ollama, vLLM, LM Studio, ...), plus an opt-in local CPU fallback with zero API dependency.

@transmitt0r/mycelium-index

"I want semantic search over my personal document/note corpus without running a vector DB server." A local, file-backed sqlite-vec index with incremental sync and hybrid lexical+semantic search (Reciprocal Rank Fusion).

@transmitt0r/mycelium-mcp

"I want my plugin's tools usable outside one specific agent host." Bridges the same tool definitions onto a standalone MCP server, over stdio and Streamable HTTP.

Plus @transmitt0r/mycelium-tooling-config: shared biome/tsconfig presets, and @transmitt0r/mycelium-openapi-codegen: shared OpenAPI-schema-to-types codegen logic used by the plugin apps' own generator scripts. Both published, but enablers rather than features in their own right.

Why "mycelium"

The fungal network that links otherwise-separate organisms and moves nutrients between them — which is the job here: linking separate personal-data sources to any LLM provider, over any transport, without each plugin reinventing the same wiring.

Development

pnpm workspaces, TypeScript 7, Biome for lint/format, Changesets for versioning and releasing the core/*/tools/* packages. Node only, deliberately — see AGENTS.md for why this isn't Bun.

pnpm install
pnpm run build
pnpm run lint
pnpm run test

See AGENTS.md for repo layout and conventions.

License

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Transmitt0r/mycelium'

If you have feedback or need assistance with the MCP directory API, please join our Discord server