How hadavidlu/oh-my-claudecode works
oh-my-claudecode is a Claude Code multi-agent orchestration product. A typical request enters through its natural-language/plugin or CLI surface, is coordinated by Team’s staged planning, execution, and verification workflow, and is supported by specialized agents and tools. The repository also provides model routing, context and memory features, persistent execution, and a live HUD. The README documents the workflow and capabilities; source excerpts show SDK setup, pipeline state handling, and HUD data collection, but not every runtime connection.
Main entry points: src/index.ts Plugin Runtime · team-pipeline Team Pipeline · cli/index.ts OMC CLI · definitions.ts Specialist Agents
Components 20
User Interfaces
- Plugin Runtime
src/index.ts - OMC CLI
src/cli/index.ts
Task Orchestration
- Team Command
src/cli/commands/team.ts - Team Pipeline
src/hooks/team-pipeline - Planning Stages
src/planning - Worker Execution
src/team - Verification
src/features/verification
Agent Capabilities
- Specialist Agents
src/agents/definitions.ts - Model Routing
src/features/model-routing - Code and Session Tools
src/tools/index.ts
Runtime Support
- Configuration
src/config/loader.ts - Context and Memory
src/features/context-injector - Pattern Learning
src/hooks/learner - Persistent Execution
src/features/continuation-enforcement.ts - Auto Update
src/features/auto-update.ts - Project Memory Storage
src/hooks/project-memory/storage.ts
Status and Updates
- Live HUD
src/hud/index.ts - Mission Board
src/hud/mission-board.ts - Notifications
src/notifications/index.ts
Other components
- Claude Code User
Connections 21
- Claude Code User → Plugin Runtime: requests work
README.md - Claude Code User → OMC CLI: runs team tasks
README.md - Plugin Runtime → Configuration: loads settings
src/index.ts - Plugin Runtime → Specialist Agents: sets up agents
src/index.ts - Plugin Runtime → Code and Session Tools: registers tools
src/index.ts - Plugin Runtime → Context and Memory: loads context
src/index.ts - Plugin Runtime → Persistent Execution: supports continuation
src/index.ts - OMC CLI → Team Command: routes command
src/cli/index.ts - Team Command → Team Pipeline: starts team flow
- Team Pipeline → Planning Stages: plans task
README.md - Team Pipeline → Worker Execution: dispatches work
README.md - Team Pipeline → Verification: verifies results
README.md - Worker Execution → Specialist Agents: uses specialists
README.md - Specialist Agents → Model Routing: selects models
- Plugin Runtime → Model Routing: enables routing
- Plugin Runtime → Pattern Learning: enables learning
- Context and Memory → Project Memory Storage: persists memory
- OMC CLI → Live HUD: offers statusline
src/cli/index.ts - Live HUD → Mission Board: refreshes board
src/hud/index.ts - OMC CLI → Auto Update: checks updates
src/cli/index.ts - Team Pipeline → Notifications: reports progress