# bigpizzav3/codexplusplus architecture

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

- Interactive diagram: https://gitdiagram.com/bigpizzav3/codexplusplus
- Repository: https://github.com/bigpizzav3/codexplusplus
- Video tour (about a minute): https://gitdiagram.com/bigpizzav3/codexplusplus/video

## Overview

Codex++ is an external launcher and management suite for the Codex/ChatGPT desktop app. The main workflow is to configure providers and optional enhancements in the manager, then launch Codex++ to apply the saved configuration and connect helper services to the running app. The graph preserves provider routing, session operations, and documented enhancement and maintenance capabilities. Several product branches are represented by their exact source modules, but their internal wiring is not shown because the sampled excerpts do not cover those implementations.

Main entry points: [`apps/codex-plus-manager/src/App.tsx`](https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-manager/src/App.tsx) (Manager UI), [`crates/codex-plus-core/src/launcher.rs`](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/launcher.rs) (Launch Runtime), [`crates/codex-plus-core/src/routes.rs`](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/routes.rs) (Bridge Routes), [`apps/codex-plus-launcher/src/main.rs`](https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-launcher/src/main.rs) (Codex++ Launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_manager["Management"]
  node_manager_ui["Manager UI<br/>[App.tsx]"]
  node_manager_commands["Manager Commands<br/>[commands.rs]"]
  node_core_settings["Settings And Config<br/>[settings.rs]"]
end

subgraph group_launch["Launch And Bridge"]
  node_launcher["Codex++ Launcher<br/>[main.rs]"]
  node_launch_core["Launch Runtime<br/>[launcher.rs]"]
  node_bridge_routes["Bridge Routes<br/>[routes.rs]"]
  node_cdp["CDP Bridge<br/>[cdp.rs]"]
end

subgraph group_providers["Provider Routing"]
  node_relay_config["Relay Profiles<br/>[relay_config.rs]"]
  node_protocol_proxy["Protocol Proxy<br/>[protocol_proxy.rs]"]
  node_aggregate_routing["Aggregate Routing<br/>[relay_rotation.rs]"]
end

subgraph group_sessions["Session Management"]
  node_sessions["Session Operations<br/>[routes.rs]"]
  node_session_storage[("Local Session Storage<br/>[storage.rs]")]
  node_backup["Session Backups<br/>[backup.rs]"]
end

subgraph group_features["Codex Capabilities"]
  node_wechat["WeChat Connector<br/>[weixin.rs]"]
  node_enhancements["UI Enhancements<br/>[bridge.rs]"]
  node_plugin_market["Plugin Marketplace"]
  node_dreamskin["DreamSkin Themes<br/>[dream_skin.rs]"]
  node_workflow["Project Workflow"]
  node_scripts["User Scripts<br/>[user_scripts.rs]"]
  node_diagnostics["Diagnostics And Updates<br/>[diagnostic_log.rs]"]
end

node_user(("User"))
node_codex_app["Codex Desktop App"]
node_provider_api["Provider APIs"]

node_user -->|"configures"| node_manager_ui
node_manager_ui -->|"requests operations"| node_manager_commands
node_manager_commands -->|"reads and writes"| node_core_settings
node_user -->|"starts"| node_launcher
node_launcher -->|"invokes launch"| node_launch_core
node_launch_core -->|"loads settings"| node_core_settings
node_launch_core -->|"starts"| node_codex_app
node_launch_core -->|"connects through"| node_cdp
node_cdp -->|"controls via CDP"| node_codex_app
node_launcher -->|"serves bridge"| node_bridge_routes
node_bridge_routes -->|"dispatches requests"| node_sessions
node_sessions -->|"reads and writes"| node_session_storage
node_session_storage -->|"creates backups"| node_backup
node_core_settings -->|"stores profiles"| node_relay_config
node_launch_core -.->|"starts when needed"| node_protocol_proxy
node_protocol_proxy -->|"translates requests"| node_provider_api
node_aggregate_routing -->|"routes requests"| node_provider_api
node_bridge_routes -->|"dispatches features"| node_enhancements
node_bridge_routes -.->|"dispatches connection"| node_wechat
node_manager_ui -->|"manages plugins"| node_plugin_market
node_manager_ui -->|"manages themes"| node_dreamskin
node_manager_ui -->|"manages projects"| node_workflow
node_bridge_routes -->|"dispatches script actions"| node_scripts
node_launcher -->|"records failures"| node_diagnostics

click node_manager_ui "https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-manager/src/App.tsx"
click node_manager_commands "https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-manager/src-tauri/src/commands.rs"
click node_core_settings "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/settings.rs"
click node_launcher "https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-launcher/src/main.rs"
click node_launch_core "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/launcher.rs"
click node_bridge_routes "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/routes.rs"
click node_cdp "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/cdp.rs"
click node_relay_config "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/relay_config.rs"
click node_protocol_proxy "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/protocol_proxy.rs"
click node_aggregate_routing "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/relay_rotation.rs"
click node_sessions "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/routes.rs"
click node_session_storage "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-data/src/storage.rs"
click node_backup "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-data/src/backup.rs"
click node_wechat "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/connect/weixin.rs"
click node_enhancements "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/bridge.rs"
click node_plugin_market "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/plugin_marketplace.rs"
click node_dreamskin "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/dream_skin.rs"
click node_workflow "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/upstream_worktree.rs"
click node_scripts "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/user_scripts.rs"
click node_diagnostics "https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/diagnostic_log.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_manager_commands,node_core_settings,node_user toneBlue
class node_launcher,node_launch_core,node_bridge_routes,node_cdp toneAmber
class node_relay_config,node_protocol_proxy,node_aggregate_routing,node_provider_api toneMint
class node_sessions,node_session_storage,node_backup toneRose
class node_wechat,node_enhancements,node_plugin_market,node_dreamskin,node_workflow,node_scripts,node_diagnostics,node_codex_app toneIndigo
```

## Components

### Management

- [Manager UI](https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-manager/src/App.tsx): `apps/codex-plus-manager/src/App.tsx`
- [Manager Commands](https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-manager/src-tauri/src/commands.rs): `apps/codex-plus-manager/src-tauri/src/commands.rs`
- [Settings And Config](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/settings.rs): `crates/codex-plus-core/src/settings.rs`

### Launch And Bridge

- [Codex++ Launcher](https://github.com/bigpizzav3/codexplusplus/blob/main/apps/codex-plus-launcher/src/main.rs): `apps/codex-plus-launcher/src/main.rs`
- [Launch Runtime](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/launcher.rs): `crates/codex-plus-core/src/launcher.rs`
- [Bridge Routes](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/routes.rs): `crates/codex-plus-core/src/routes.rs`
- [CDP Bridge](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/cdp.rs): `crates/codex-plus-core/src/cdp.rs`

### Provider Routing

- [Relay Profiles](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/relay_config.rs): `crates/codex-plus-core/src/relay_config.rs`
- [Protocol Proxy](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/protocol_proxy.rs): `crates/codex-plus-core/src/protocol_proxy.rs`
- [Aggregate Routing](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/relay_rotation.rs): `crates/codex-plus-core/src/relay_rotation.rs`

### Session Management

- [Session Operations](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/routes.rs): `crates/codex-plus-core/src/routes.rs`
- [Local Session Storage](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-data/src/storage.rs): `crates/codex-plus-data/src/storage.rs`
- [Session Backups](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-data/src/backup.rs): `crates/codex-plus-data/src/backup.rs`

### Codex Capabilities

- [WeChat Connector](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/connect/weixin.rs): `crates/codex-plus-core/src/connect/weixin.rs`
- [UI Enhancements](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/bridge.rs): `crates/codex-plus-core/src/bridge.rs`
- [Plugin Marketplace](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/plugin_marketplace.rs): `crates/codex-plus-core/src/plugin_marketplace.rs`
- [DreamSkin Themes](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/dream_skin.rs): `crates/codex-plus-core/src/dream_skin.rs`
- [Project Workflow](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/upstream_worktree.rs): `crates/codex-plus-core/src/upstream_worktree.rs`
- [User Scripts](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/user_scripts.rs): `crates/codex-plus-core/src/user_scripts.rs`
- [Diagnostics And Updates](https://github.com/bigpizzav3/codexplusplus/blob/main/crates/codex-plus-core/src/diagnostic_log.rs): `crates/codex-plus-core/src/diagnostic_log.rs`

### Other components

- **User**
- **Codex Desktop App**
- **Provider APIs**

## Connections

- User → Manager UI: configures
- Manager UI → Manager Commands: requests operations
- Manager Commands → Settings And Config: reads and writes
- User → Codex++ Launcher: starts
- Codex++ Launcher → Launch Runtime: invokes launch
- Launch Runtime → Settings And Config: loads settings
- Launch Runtime → Codex Desktop App: starts
- Launch Runtime → CDP Bridge: connects through
- CDP Bridge → Codex Desktop App: controls via CDP
- Codex++ Launcher → Bridge Routes: serves bridge
- Bridge Routes → Session Operations: dispatches requests
- Session Operations → Local Session Storage: reads and writes
- Local Session Storage → Session Backups: creates backups
- Settings And Config → Relay Profiles: stores profiles
- Launch Runtime → Protocol Proxy: starts when needed
- Protocol Proxy → Provider APIs: translates requests
- Aggregate Routing → Provider APIs: routes requests
- Bridge Routes → UI Enhancements: dispatches features
- Bridge Routes → WeChat Connector: dispatches connection
- Manager UI → Plugin Marketplace: manages plugins
- Manager UI → DreamSkin Themes: manages themes
- Manager UI → Project Workflow: manages projects
- Bridge Routes → User Scripts: dispatches script actions
- Codex++ Launcher → Diagnostics And Updates: records failures