How bytepioneer-ai/codex-host works
CodexHost embeds multiple agent harnesses in Codex Desktop. The user launches CodexHost, which starts the desktop integration; the Host Runtime coordinates harness sessions, while adapters translate harness-specific behavior into CodexHost’s shared protocol and renderer-facing experience. The repository also includes remote execution, delegation, diagnostics, and update paths. The README establishes the product capabilities; sampled source confirms selected entry points and services, but not all runtime wiring, so uncertain links are omitted.
Main entry points: main.ts Host Runtime · main.rs Launcher · production-entry.ts Renderer Extension · app.ts Console UI
Components 21
Launch and Platform
- Launcher
crates/launcher/src/main.rs - Platform Services
crates/platform/src/lib.rs - Desktop Shim
crates/shim/src/main.rs
Harness Runtime
- Host Runtime
packages/host-runtime/src/main.ts - Harness Discovery
packages/harness-discovery/src/index.ts - Harness Adapters
packages/adapters - Protocol Core
packages/protocol-core/src/index.ts - Harness Broker
packages/harness-broker/src/server.ts
Desktop Experience
- Renderer Extension
packages/renderer-extension/src/production-entry.ts - Desktop Control
packages/desktop-control/src/production-controller.ts - Session Mapping
packages/mapping-store/src/mapping-store.ts
Remote and Collaboration
- Delegation
packages/host-runtime/src/delegation-cli.ts - Remote Host
packages/host-runtime/src/remote-host-cli.ts - Remote Bridge
packages/host-runtime/src/remote-control-app-server.ts
Operations
- Console Server
packages/console-server/src/server.ts - Console UI
packages/renderer-extension/src/console/app.ts - Update Manager
packages/update-manager/src/update-manager.ts - Updater
crates/updater/src/main.rs
Other components
- User
- Codex Desktop
- Agent Harnesses
Connections 22
- User → Launcher: launches
- Launcher → Platform Services: uses platform services
- Launcher → Codex Desktop: starts desktop integration
- Codex Desktop → Desktop Shim: invokes
- Desktop Shim → Host Runtime: starts runtime
- Host Runtime → Harness Discovery: discovers harnesses
- Host Runtime → Harness Adapters: loads integrations
- Harness Adapters → Agent Harnesses: translates harness behavior
- Host Runtime → Protocol Core: uses shared protocol
- Host Runtime → Harness Broker: brokers harness sessions
- Host Runtime → Renderer Extension: supplies session experience
- Renderer Extension → Codex Desktop: integrates with interface
- Desktop Control → Codex Desktop: controls renderer
- Renderer Extension → Session Mapping: maps sessions
- Host Runtime → Delegation: dispatches delegation
- Host Runtime → Remote Host: supports remote execution
- Remote Bridge → Remote Host: bridges remote control
- User → Console UI: opens console
- Console UI → Console Server: requests diagnostics
- Console Server → Host Runtime: inspects runtime
- Console UI → Update Manager: requests updates
- Update Manager → Updater: prepares update