How cheriwen/codexplusplus works
Codex++ is an external launcher and management tool that enhances Codex without modifying its installation: the launcher starts Codex and injects scripts through CDP, while the manager configures features and runs maintenance actions. The main path is manager or silent-launcher entry → Rust backend → Codex launch/injection and bridge requests. Major documented branches include relay configuration, scripts, session tools, provider sync, worktrees, Zed remote opening, and updates. Some branches are represented from README claims and tree paths; their internal wiring was not sampled.
Main entry points: launcher.rs Launch orchestration · routes.rs Bridge request routes · main.rs Silent launcher · App.tsx Manager UI
Components 24
User entrypoints
- Silent launcher
apps/codex-plus-launcher/src/main.rs - Manager UI
apps/codex-plus-manager/src/App.tsx
Management control
- Manager commands
apps/codex-plus-manager/src-tauri/src/commands.rs - Entry management
crates/codex-plus-core/src/install/mod.rs - Settings and profiles
crates/codex-plus-core/src/settings.rs - Update checks
crates/codex-plus-core/src/update.rs
Launch and injection
- Launch orchestration
crates/codex-plus-core/src/launcher.rs - CDP injection
crates/codex-plus-core/src/cdp.rs - Injected bridge
crates/codex-plus-core/src/bridge.rs - Bridge request routes
crates/codex-plus-core/src/routes.rs
Enhancement features
- Relay proxy
crates/codex-plus-core/src/proxy.rs - User scripts
crates/codex-plus-core/src/user_scripts.rs - UI enhancements
crates/codex-plus-core/src/assets.rs - Upstream worktrees
crates/codex-plus-core/src/upstream_worktree.rs - Zed remote open
crates/codex-plus-core/src/zed_remote.rs
Session data
- Session data service
apps/codex-plus-launcher/src/main.rs - SQLite session adapter
crates/codex-plus-data/src/storage.rs - Session backups
crates/codex-plus-data/src/backup.rs - Provider sync
crates/codex-plus-data/src/provider_sync.rs
Other components
- User
- Codex App
- Relay API
- GitHub Releases
- Zed Remote
Connections 26
- User → Silent launcher: starts silently
- User → Manager UI: opens controls
- Manager UI → Manager commands: invokes commands
- Manager commands → Settings and profiles: reads and writes
- Manager commands → Entry management: manages entrypoints
- Silent launcher → Launch orchestration: starts launch
- Launch orchestration → Settings and profiles: loads configuration
- Launch orchestration → Codex App: launches process
- Launch orchestration → CDP injection: requests injection
- CDP injection → Codex App: injects via CDP
- CDP injection → Injected bridge: installs bridge
- Injected bridge → Bridge request routes: dispatches requests
- Bridge request routes → User scripts: manages scripts
- Bridge request routes → Upstream worktrees: creates worktrees
- Bridge request routes → Zed remote open: requests remote open
- Bridge request routes → Session data service: dispatches session actions
- Session data service → SQLite session adapter: runs data operations
- SQLite session adapter → Session backups: writes and restores
- Launch orchestration → Provider sync: syncs before launch
- Launch orchestration → Relay proxy: starts relay mode
- Relay proxy → Relay API: forwards requests
- Launch orchestration → UI enhancements: injects enhancement assets
- Zed remote open → Zed Remote: opens remote context
- Manager UI → Update checks: checks updates
- Silent launcher → Update checks: checks updates
- Update checks → GitHub Releases: checks releases