mycelium-core

Mycelium - Distributed Intelligence for Claude Code

Mycelium: Like nature's mycelial networks that communicate through chemical signals, distribute resources efficiently, and exhibit emergent intelligence - this Claude Code plugin creates an ecosystem of expert subagents that collaborate in real-time.

What is Mycelium?

Mycelium is a comprehensive Claude Code plugin providing:

• 130+ Expert Agents across 11 domains (Python, DevOps, AI/ML, Security, and more)
• Dual-Mode Coordination with auto-detection (Redis/TaskQueue/Markdown)
• Real-time Messaging via pub/sub for agent collaboration
• Durable Workflows with Temporal integration
• Infrastructure Monitoring with /infra-check, /team-status, /pipeline-status commands
• Event-Driven Automation via hooks system
• Fast Agent Discovery with lazy loading (105x faster, 67% memory reduction)
• Performance Analytics with privacy-first telemetry (local-only, no PII)

Quick Start

Installation

# Option 1: Plugin Marketplace (recommended)
/plugin marketplace add gsornsen/mycelium
/plugin install mycelium-core@mycelium

# Option 2: Direct from GitHub
claude plugin install git+https://github.com/gsornsen/mycelium.git

# Option 3: Local development
ln -s /path/to/mycelium ~/.claude/plugins/mycelium

Important: Restart Claude Code completely after installation to load all 130+ agents.

Verification

# Check infrastructure health
/infra-check

# Verify agents loaded (should see 119+ mycelium agents)
/agents

# Check coordination status
/team-status

First Steps

1. Choose coordination mode - Redis (production), TaskQueue (task-centric), or Markdown (zero-setup)
2. Set up infrastructure - Start Redis/Temporal if using those modes
3. Invoke agents - Use @agent-name to activate specialists
4. Monitor status - Use /team-status and /infra-check commands

📖 New User? See .mycelium/modules/onboarding.md for complete setup guide.

Core Concepts

The Mycelial Network Metaphor

        🍄 Orchestrators (coordinate workflows)
           /        |        \
      Agents    Agents    Agents (specialized experts)
           \        |        /
      ============================
         Substrate (coordination)
         - Redis (real-time)
         - TaskQueue (structured)
         - Markdown (offline)
      ============================

Key Terms:

• Spores - Individual specialized agents (130+ available)
• Fruiting Bodies - Meta-orchestrators that coordinate multi-agent workflows
• Hyphae - Durable workflow threads connecting agents
• Substrate - Coordination infrastructure (auto-detects best available mode)

Agent Categories

Category	Agents	Description
Core Development	python-pro, ai-engineer, javascript-expert, typescript-specialist, rust-developer	Primary language specialists
Infrastructure	devops-engineer, kubernetes-specialist, docker-expert, security-auditor	DevOps and deployment
Data & AI	data-engineer, ml-engineer, nlp-specialist, computer-vision-expert	ML and data science
Quality & Security	qa-engineer, test-automation-specialist, performance-engineer	Testing and optimization
Developer Experience	cli-developer, documentation-engineer, mcp-specialist	Tools and documentation
Meta-Orchestration	multi-agent-coordinator, workflow-orchestrator, task-distributor	Workflow coordination
+ 5 more categories		See .mycelium/modules/agents.md

📖 Learn More: See .mycelium/modules/agents.md for complete agent catalog.

Agent Discovery

Mycelium features fast, lazy-loading agent discovery (105x faster than traditional loading):

from scripts.agent_discovery import AgentDiscovery
from pathlib import Path