# hadavidlu/oh-my-claudecode architecture

> Architecture diagram of the GitHub repository hadavidlu/oh-my-claudecode, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hadavidlu/oh-my-claudecode
- Repository: https://github.com/hadavidlu/oh-my-claudecode

## Overview

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`](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/index.ts) (Plugin Runtime), [`src/hooks/team-pipeline`](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/hooks/team-pipeline) (Team Pipeline), [`src/cli/index.ts`](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/cli/index.ts) (OMC CLI), [`src/agents/definitions.ts`](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/agents/definitions.ts) (Specialist Agents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User Interfaces"]
  node_plugin["Plugin Runtime<br/>[index.ts]"]
  node_cli["OMC CLI<br/>[index.ts]"]
end

subgraph group_orchestration["Task Orchestration"]
  node_team_command["Team Command<br/>[team.ts]"]
  node_team_pipeline["Team Pipeline"]
  node_planning["Planning Stages"]
  node_execution["Worker Execution"]
  node_verification["Verification"]
end

subgraph group_capabilities["Agent Capabilities"]
  node_agents["Specialist Agents<br/>[definitions.ts]"]
  node_model_routing["Model Routing"]
  node_tools["Code and Session Tools<br/>[index.ts]"]
end

subgraph group_runtime["Runtime Support"]
  node_configuration["Configuration<br/>[loader.ts]"]
  node_context["Context and Memory"]
  node_learning["Pattern Learning"]
  node_persistence["Persistent Execution"]
  node_auto_update["Auto Update<br/>[auto-update.ts]"]
  node_state_storage[("Project Memory Storage<br/>[storage.ts]")]
end

subgraph group_visibility["Status and Updates"]
  node_hud["Live HUD<br/>[index.ts]"]
  node_mission_board["Mission Board<br/>[mission-board.ts]"]
  node_notifications["Notifications<br/>[index.ts]"]
end

node_user(("Claude Code User"))

node_user -->|"requests work"| node_plugin
node_user -->|"runs team tasks"| node_cli
node_plugin -->|"loads settings"| node_configuration
node_plugin -->|"sets up agents"| node_agents
node_plugin -->|"registers tools"| node_tools
node_plugin -->|"loads context"| node_context
node_plugin -.->|"supports continuation"| node_persistence
node_cli -->|"routes command"| node_team_command
node_team_command -.->|"starts team flow"| node_team_pipeline
node_team_pipeline -->|"plans task"| node_planning
node_team_pipeline -->|"dispatches work"| node_execution
node_team_pipeline -->|"verifies results"| node_verification
node_execution -->|"uses specialists"| node_agents
node_agents -.->|"selects models"| node_model_routing
node_plugin -.->|"enables routing"| node_model_routing
node_plugin -.->|"enables learning"| node_learning
node_context -.->|"persists memory"| node_state_storage
node_cli -.->|"offers statusline"| node_hud
node_hud -->|"refreshes board"| node_mission_board
node_cli -->|"checks updates"| node_auto_update
node_team_pipeline -.->|"reports progress"| node_notifications

click node_plugin "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/index.ts"
click node_cli "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/cli/index.ts"
click node_configuration "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/config/loader.ts"
click node_team_command "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/cli/commands/team.ts"
click node_team_pipeline "https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/hooks/team-pipeline"
click node_planning "https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/planning"
click node_execution "https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/team"
click node_verification "https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/features/verification"
click node_agents "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/agents/definitions.ts"
click node_model_routing "https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/features/model-routing"
click node_tools "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/tools/index.ts"
click node_context "https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/features/context-injector"
click node_learning "https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/hooks/learner"
click node_persistence "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/features/continuation-enforcement.ts"
click node_hud "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/hud/index.ts"
click node_mission_board "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/hud/mission-board.ts"
click node_notifications "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/notifications/index.ts"
click node_auto_update "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/features/auto-update.ts"
click node_state_storage "https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/hooks/project-memory/storage.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_cli,node_user toneBlue
class node_team_command,node_team_pipeline,node_planning,node_execution,node_verification toneAmber
class node_agents,node_model_routing,node_tools toneMint
class node_configuration,node_context,node_learning,node_persistence,node_auto_update,node_state_storage toneRose
class node_hud,node_mission_board,node_notifications toneIndigo
```

## Components

### User Interfaces

- [Plugin Runtime](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/index.ts): `src/index.ts`
- [OMC CLI](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/cli/index.ts): `src/cli/index.ts`

### Task Orchestration

- [Team Command](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/cli/commands/team.ts): `src/cli/commands/team.ts`
- [Team Pipeline](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/hooks/team-pipeline): `src/hooks/team-pipeline`
- [Planning Stages](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/planning): `src/planning`
- [Worker Execution](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/team): `src/team`
- [Verification](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/features/verification): `src/features/verification`

### Agent Capabilities

- [Specialist Agents](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/agents/definitions.ts): `src/agents/definitions.ts`
- [Model Routing](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/features/model-routing): `src/features/model-routing`
- [Code and Session Tools](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/tools/index.ts): `src/tools/index.ts`

### Runtime Support

- [Configuration](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/config/loader.ts): `src/config/loader.ts`
- [Context and Memory](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/features/context-injector): `src/features/context-injector`
- [Pattern Learning](https://github.com/hadavidlu/oh-my-claudecode/tree/main/src/hooks/learner): `src/hooks/learner`
- [Persistent Execution](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/features/continuation-enforcement.ts): `src/features/continuation-enforcement.ts`
- [Auto Update](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/features/auto-update.ts): `src/features/auto-update.ts`
- [Project Memory Storage](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/hooks/project-memory/storage.ts): `src/hooks/project-memory/storage.ts`

### Status and Updates

- [Live HUD](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/hud/index.ts): `src/hud/index.ts`
- [Mission Board](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/hud/mission-board.ts): `src/hud/mission-board.ts`
- [Notifications](https://github.com/hadavidlu/oh-my-claudecode/blob/main/src/notifications/index.ts): `src/notifications/index.ts`

### Other components

- **Claude Code User**

## Connections

- Claude Code User → Plugin Runtime: requests work (evidence: `README.md`)
- Claude Code User → OMC CLI: runs team tasks (evidence: `README.md`)
- Plugin Runtime → Configuration: loads settings (evidence: `src/index.ts`)
- Plugin Runtime → Specialist Agents: sets up agents (evidence: `src/index.ts`)
- Plugin Runtime → Code and Session Tools: registers tools (evidence: `src/index.ts`)
- Plugin Runtime → Context and Memory: loads context (evidence: `src/index.ts`)
- Plugin Runtime → Persistent Execution: supports continuation (evidence: `src/index.ts`)
- OMC CLI → Team Command: routes command (evidence: `src/cli/index.ts`)
- Team Command → Team Pipeline: starts team flow
- Team Pipeline → Planning Stages: plans task (evidence: `README.md`)
- Team Pipeline → Worker Execution: dispatches work (evidence: `README.md`)
- Team Pipeline → Verification: verifies results (evidence: `README.md`)
- Worker Execution → Specialist Agents: uses specialists (evidence: `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 (evidence: `src/cli/index.ts`)
- Live HUD → Mission Board: refreshes board (evidence: `src/hud/index.ts`)
- OMC CLI → Auto Update: checks updates (evidence: `src/cli/index.ts`)
- Team Pipeline → Notifications: reports progress
