← all repositories
BytePioneer-AI/codex-host

CodexHost Turns Codex Desktop Into a Universal Agent Shell

It keeps Codex Desktop's polished interface while letting you delegate actual coding work to Pi, Claude Code, and other harnesses natively.

★3k stars TypeScript Coding AssistantsAgents
codex-host
Velocity · 7d
+44
★ / day
Trend
↗accelerating
star history

What it does

CodexHost is a shim that turns OpenAI’s Codex Desktop into a multi-agent workspace. It uses CDP and Electron Inspector to inject agent selection into the official app, then routes your commands to Pi, Claude Code, Grok Build, DeepSeek Harness, or Oh My Pi through their native interfaces. You keep Codex Desktop’s UI; the harnesses supply the brains.

The interesting bit

Instead of flattening every backend behind a generic protocol like ACP, CodexHost projects each harness’s native streaming, tool states, diffs, and approval flows directly into Codex Desktop’s existing chrome. When you delegate a task to another agent, it spins up an independent Native Session so they can work in parallel without hijacking your main thread.

Key highlights

  • Runs Pi, Claude Code, Grok Build, DeepSeek Harness, and Oh My Pi as independent threads inside a single Codex Desktop window
  • Preserves native capabilities like tool status, edit diffs, model selection, and permission approvals rather than emulating them
  • Cross-agent delegation spawns separate sessions you can background or monitor without losing context
  • Remote SSH and Remote Control modes let you run harnesses on another machine while keeping the UI local
  • Adds usage cost estimation, context compression, and Mermaid diagram rendering

Caveats

  • Requires the official Codex Desktop app; it is an enhancer, not a standalone client
  • Feature parity varies: Oh My Pi lacks tool approval, Pi lacks permission mode, and DeepSeek Harness cannot revise the last message
  • Windows Remote Control support is explicitly marked experimental

Verdict

A pragmatic fit if you want Codex Desktop’s UX with Claude Code’s or Pi’s capabilities. If you need a fully vendor-neutral client, look elsewhere—this is essentially sophisticated glue code that lives inside OpenAI’s ecosystem.

Frequently asked

What is BytePioneer-AI/codex-host?
It keeps Codex Desktop's polished interface while letting you delegate actual coding work to Pi, Claude Code, and other harnesses natively.
Is codex-host open source?
Yes — BytePioneer-AI/codex-host is open source, released under the LGPL-3.0 license.
What language is codex-host written in?
BytePioneer-AI/codex-host is primarily written in TypeScript.
How popular is codex-host?
BytePioneer-AI/codex-host has 3k stars on GitHub and is currently accelerating.
Where can I find codex-host?
BytePioneer-AI/codex-host is on GitHub at https://github.com/BytePioneer-AI/codex-host.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.