# damonzs/claude-codex-pro-tool architecture

> Architecture diagram of the GitHub repository damonzs/claude-codex-pro-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/damonzs/claude-codex-pro-tool
- Repository: https://github.com/damonzs/claude-codex-pro-tool

## Overview

Claude Codex Pro is a local-first Windows/macOS AI operations console. The main workflow is an operator using the Tauri manager to configure providers, clients, or extensions; backend routes then perform local configuration and client operations. A separate embedded workflow surface presents Multica task and automation views while delegating execution to Codex-native threads. The graph preserves documented product capabilities and indexed core modules; several subsystem links rely on README descriptions because their implementation was not sampled.

Main entry points: [`crates/claude-codex-pro-core/src/routes.rs`](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/routes.rs) (Command Routes), [`apps/claude-codex-pro-manager/src/App.tsx`](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/claude-codex-pro-manager/src/App.tsx) (Manager Console), [`crates/claude-codex-pro-core/src/multica_workspace.rs`](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_workspace.rs) (Workspace Control), [`apps/codex-workflow-surface/src/main.tsx`](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/main.tsx) (Workflow Surface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_manager["Manager UI"]
  node_manager_ui["Manager Console<br/>[App.tsx]"]
  node_backend_routes["Command Routes<br/>[routes.rs]"]
end

subgraph group_provider["Providers and Clients"]
  node_settings["Provider Settings<br/>[settings.rs]"]
  node_api_providers{{"API Providers"}}
  node_claude_desktop["Claude Desktop<br/>[claude_desktop.rs]"]
  node_client_deploy["Client Maintenance<br/>[client_deploy.rs]"]
end

subgraph group_codex["Codex Workflows"]
  node_codex_execution["Codex Page Host<br/>[codex_execution.rs]"]
  node_codex_app{{"Codex App"}}
  node_workspace["Workspace Control"]
  node_execution["Native Execution"]
  node_execution_store[("Execution Records")]
  node_native_subtasks["Native Subtasks<br/>[native_subtasks.rs]"]
  node_sessions[("Session Data<br/>[storage.rs]")]
end

subgraph group_workflow["Embedded Workflow"]
  node_workflow_ui["Workflow Surface<br/>[main.tsx]"]
  node_api_adapter["Workspace Adapter"]
  node_execution_board["Execution Board"]
  node_runtime_bridge["Runtime Bridge<br/>[runtime-bridge.ts]"]
end

subgraph group_extensions["Extensions and Prompts"]
  node_system_prompts["System Prompts"]
  node_plugin_hub["Plugin Hub<br/>[plugin_hub.rs]"]
  node_skill_trust["Skill Trust"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_manager_ui
node_manager_ui -->|"invokes commands"| node_backend_routes
node_backend_routes -->|"routes configuration"| node_settings
node_settings -->|"configures"| node_api_providers
node_backend_routes -->|"routes operations"| node_claude_desktop
node_backend_routes -->|"routes maintenance"| node_client_deploy
node_backend_routes -->|"routes execution"| node_codex_execution
node_codex_execution -->|"uses page host"| node_codex_app
node_backend_routes -->|"routes workspace"| node_workspace
node_backend_routes -->|"routes execution"| node_execution
node_execution -.->|"records attempts"| node_execution_store
node_workspace -->|"reads metadata"| node_native_subtasks
node_operator -->|"opens pages"| node_workflow_ui
node_workflow_ui -->|"loads workspace"| node_api_adapter
node_api_adapter -->|"uses bridge"| node_runtime_bridge
node_api_adapter -->|"uses board"| node_execution_board
node_workflow_ui -->|"delegates execution"| node_codex_app
node_manager_ui -->|"manages templates"| node_system_prompts
node_backend_routes -.->|"routes plugins"| node_plugin_hub
node_workspace -->|"checks trust"| node_skill_trust
node_backend_routes -->|"routes session data"| node_sessions

click node_manager_ui "https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/claude-codex-pro-manager/src/App.tsx"
click node_backend_routes "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/routes.rs"
click node_settings "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/settings.rs"
click node_claude_desktop "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/claude_desktop.rs"
click node_client_deploy "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/client_deploy.rs"
click node_codex_execution "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/codex_execution.rs"
click node_workspace "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_workspace.rs"
click node_execution "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_execution.rs"
click node_execution_store "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_execution_store.rs"
click node_native_subtasks "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_workspace/native_subtasks.rs"
click node_workflow_ui "https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/main.tsx"
click node_api_adapter "https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/multica-api-adapter.ts"
click node_execution_board "https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/multica-execution-board.ts"
click node_runtime_bridge "https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/runtime-bridge.ts"
click node_system_prompts "https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/claude-codex-pro-manager/src/services/system-prompt.service.ts"
click node_plugin_hub "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/plugin_hub.rs"
click node_skill_trust "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_skill_trust.rs"
click node_sessions "https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-data/src/storage.rs"

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_manager_ui,node_backend_routes toneBlue
class node_settings,node_api_providers,node_claude_desktop,node_client_deploy toneAmber
class node_codex_execution,node_codex_app,node_workspace,node_execution,node_execution_store,node_native_subtasks,node_sessions toneMint
class node_workflow_ui,node_api_adapter,node_execution_board,node_runtime_bridge toneRose
class node_system_prompts,node_plugin_hub,node_skill_trust,node_operator toneIndigo
```

## Components

### Manager UI

- [Manager Console](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/claude-codex-pro-manager/src/App.tsx): `apps/claude-codex-pro-manager/src/App.tsx`
- [Command Routes](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/routes.rs): `crates/claude-codex-pro-core/src/routes.rs`

### Providers and Clients

- [Provider Settings](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/settings.rs): `crates/claude-codex-pro-core/src/settings.rs`
- **API Providers**
- [Claude Desktop](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/claude_desktop.rs): `crates/claude-codex-pro-core/src/claude_desktop.rs`
- [Client Maintenance](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/client_deploy.rs): `crates/claude-codex-pro-core/src/client_deploy.rs`

### Codex Workflows

- [Codex Page Host](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/codex_execution.rs): `crates/claude-codex-pro-core/src/codex_execution.rs`
- **Codex App**
- [Workspace Control](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_workspace.rs): `crates/claude-codex-pro-core/src/multica_workspace.rs`
- [Native Execution](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_execution.rs): `crates/claude-codex-pro-core/src/multica_execution.rs`
- [Execution Records](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_execution_store.rs): `crates/claude-codex-pro-core/src/multica_execution_store.rs`
- [Native Subtasks](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_workspace/native_subtasks.rs): `crates/claude-codex-pro-core/src/multica_workspace/native_subtasks.rs`
- [Session Data](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-data/src/storage.rs): `crates/claude-codex-pro-data/src/storage.rs`

### Embedded Workflow

- [Workflow Surface](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/main.tsx): `apps/codex-workflow-surface/src/main.tsx`
- [Workspace Adapter](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/multica-api-adapter.ts): `apps/codex-workflow-surface/src/multica-api-adapter.ts`
- [Execution Board](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/multica-execution-board.ts): `apps/codex-workflow-surface/src/multica-execution-board.ts`
- [Runtime Bridge](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/codex-workflow-surface/src/runtime-bridge.ts): `apps/codex-workflow-surface/src/runtime-bridge.ts`

### Extensions and Prompts

- [System Prompts](https://github.com/damonzs/claude-codex-pro-tool/blob/main/apps/claude-codex-pro-manager/src/services/system-prompt.service.ts): `apps/claude-codex-pro-manager/src/services/system-prompt.service.ts`
- [Plugin Hub](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/plugin_hub.rs): `crates/claude-codex-pro-core/src/plugin_hub.rs`
- [Skill Trust](https://github.com/damonzs/claude-codex-pro-tool/blob/main/crates/claude-codex-pro-core/src/multica_skill_trust.rs): `crates/claude-codex-pro-core/src/multica_skill_trust.rs`

### Other components

- **Operator**

## Connections

- Operator → Manager Console: uses (evidence: `README.md`)
- Manager Console → Command Routes: invokes commands (evidence: `README.md`)
- Command Routes → Provider Settings: routes configuration (evidence: `crates/claude-codex-pro-core/src/routes.rs`)
- Provider Settings → API Providers: configures (evidence: `README.md`)
- Command Routes → Claude Desktop: routes operations (evidence: `crates/claude-codex-pro-core/src/routes.rs`)
- Command Routes → Client Maintenance: routes maintenance (evidence: `crates/claude-codex-pro-core/src/routes.rs`)
- Command Routes → Codex Page Host: routes execution (evidence: `crates/claude-codex-pro-core/src/routes.rs`)
- Codex Page Host → Codex App: uses page host (evidence: `README.md`)
- Command Routes → Workspace Control: routes workspace (evidence: `crates/claude-codex-pro-core/src/routes.rs`)
- Command Routes → Native Execution: routes execution (evidence: `crates/claude-codex-pro-core/src/routes.rs`)
- Native Execution → Execution Records: records attempts (evidence: `crates/claude-codex-pro-core/src/multica_execution_store.rs`)
- Workspace Control → Native Subtasks: reads metadata (evidence: `crates/claude-codex-pro-core/src/multica_workspace.rs`)
- Operator → Workflow Surface: opens pages (evidence: `README.md`)
- Workflow Surface → Workspace Adapter: loads workspace (evidence: `apps/codex-workflow-surface/src/main.tsx`)
- Workspace Adapter → Runtime Bridge: uses bridge (evidence: `apps/codex-workflow-surface/src/multica-api-adapter.ts`)
- Workspace Adapter → Execution Board: uses board (evidence: `apps/codex-workflow-surface/src/multica-api-adapter.ts`)
- Workflow Surface → Codex App: delegates execution (evidence: `README.md`)
- Manager Console → System Prompts: manages templates (evidence: `README.md`)
- Command Routes → Plugin Hub: routes plugins
- Workspace Control → Skill Trust: checks trust (evidence: `crates/claude-codex-pro-core/src/multica_workspace.rs`)
- Command Routes → Session Data: routes session data (evidence: `crates/claude-codex-pro-core/src/routes.rs`)