🍄 Mycelium

One mushroom to rule them all.

Sync your skills, MCPs, agents, rules, and hooks across every AI tool, from every machine — one config.

---

🚀 Quick Start

npm install -g @mycelish/cli
mycelium init

init detects your tools, migrates existing configs, syncs everything, and registers Mycelium as an MCP server in every tool. New machine? Run init again.

mycelium sync              # Push config to all tools
mycelium sync --watch      # Auto-sync on changes
mycelium serve             # Launch visual dashboard

---

✨ What It Does

🔄 Universal Sync	6 item types × 8 tools. One command. Your manual settings are preserved.
🏗️ 3-Tier Config	Project > Machine > Global. Different MCPs per project, different paths per machine.
🧩 Plugin Takeover	Disable individual skills, agents, or commands within a plugin — without disabling the entire plugin.
💻 Multi-PC Sync	Push/pull via Git. MCP paths auto-detected per hostname. Secrets gitignored, templates tracked.
🪄 Migration Wizard	Scans all tools, generates a plan, imports everything. Dry-run by default.
🛡️ Security Scanner	80+ rules scan every skill before install. Catches prompt injection, credential harvesting, and more.
🔌 MCP Server	Mycelium registers itself as MCP — any AI tool can manage its own config via natural language.
📊 Observability	SQLite traces, auto-snapshots on errors, queryable reports.
🖥️ Dashboard	React Flow graph, toggle switches, migration wizard, marketplace browser.
🩺 Doctor	8 health modules catch broken symlinks, missing MCPs, and config drift.

---

🎯 Supported Tools

Tool	Skills	MCPs	Agents	Rules	Hooks	Commands
Claude Code	✅	✅	✅	—	✅	—
Codex CLI	✅	✅	—	✅	✅	—
Gemini CLI	✅	✅	—	—	✅	—
OpenCode	✅	✅	✅	—	✅	✅
OpenClaw	✅	✅	—	—	✅	—
Cursor	—	✅	✅	✅	✅	✅
VS Code	✅	✅	✅	✅	—	—
Antigravity	✅	✅	✅	—	—	—

---

📋 Commands

Command	Description
mycelium init	Auto-setup: detect, migrate, sync, register MCP
mycelium sync [--watch]	Sync to all tools
mycelium status	Show sync status across tools
mycelium doctor [--security]	Health checks + security scan
mycelium add / remove	Add or remove skills and MCPs
mycelium enable / disable	Enable or disable items (with plugin takeover)
mycelium migrate [--apply]	Scan and import from existing tools
mycelium marketplace	Browse and manage marketplace
mycelium push / pull	Git-based multi-PC sync
mycelium env	Environment variable management
mycelium report	Query traces and generate reports
mycelium serve	Start dashboard on port 3378

Alias: myc — e.g., myc sync, myc status

---

📚 Docs

• Capability Matrix — Full tool × item type support
• MCP Server — Tools, resources, prompts reference
• Plugin Takeover — Per-component plugin control
• Multi-PC Sync — Machine overrides, env templates
• Migration Guide — Workflow and strategies
• Reporting Issues — Diagnostics and bug reports

---

📄 MIT License