bytepioneer-ai/codex-host

Sponsors

Interface Preview

No more switching apps: Pi, Claude Code, Grok Build, and ten-plus other Harnesses all run right inside the same Codex Desktop window.

https://github.com/user-attachments/assets/c48192d7-23ff-4f6e-b61a-6345a655bb76

Interface

Quick Start

Option 1: npm (macOS / Windows / Linux)

npm install -g @codexhost/cli
codexhost

Option 2: Installer (macOS / Windows)

Grab the installer for your platform from Releases.

Linux is supported on x64 and ARM64. See the Linux guide.

Run codexhost update to check for the latest release and prepare an upgrade from your terminal. Quit Codex Desktop first if an upgrade is available. Once preparation completes, the background updater installs it and restarts codexhost. An up-to-date installation exits without changes.

Highlights

Feature Status

Every Harness gets Codex Desktop’s native Edit Diff, Fork, message editing, and slash commands.

Cross-Agent Collaboration

Type # in the chat input to choose an Agent to delegate a task to, or to find commands and skills available for the selected Harness.

Ask the current Agent to hand off a self-contained task to another Harness. For example:

Have #claude-code review this change on its own and flag any compatibility risks.

Have #pi figure out why this test is flaky.

Have #omp implement this feature while I keep working on the docs.

Have #opencode verify this fix in a separate Thread and run the related tests.

CodexHost spins up a separate Native Session in the target Harness. It shows up in the Codex Desktop conversation list, so you can open it anytime to check progress or pick up the conversation.

微信交流群

Development

Please read the contributing guide before opening an issue or PR. See repository maintenance automation for PR title labels, CI summaries, and pre-release checks.

Requirements: the official Codex Desktop, Node.js 22.19+ or 24, and Rust.

git clone https://github.com/BytePioneer-AI/codex-host
cd codex-host
npm ci
npm start

To run the current source with a specific runtime version, use npm start 0.12.0 (prereleases such as 0.13.0-rc.1 are also accepted). Host status, console version and update-check version reporting use this value. Without a version argument the version remains -dev; npm start 0.12.0 -- --no-build reuses artifacts after building once. The override lasts for this launch and does not modify version files or publish packages. Source installations still lack packaged self-update resources; remote npm installation downloads the published package with that version, not the local source.

Runtime Architecture

Using Pi as an example, here is how a single request flows from left to right: Desktop → shared layer → Pi plugin → native process.

Adding a Harness

Most of the work is implementing the plugin’s Manifest, factory, Adapter, and Session, plus the native communication and translation logic. The Renderer still has some hard-coded wiring, so full Desktop integration takes extra work.

Tip: point your coding Agent at the in-repo codexhost-add-harness Skill. It covers plugin structure, the shared Adapter interface, capability implementation, and testing requirements.

Acknowledgements

• Thanks to the LINUX DO community for their ongoing support.
• Thanks to Paseo, whose approach to multi-Harness integration and architecture inspired ours.

Contributors

Thanks to everyone who has contributed to CodexHost.

Star History