⬛ A native connected terminal for AI agent development. 为 AI Agent 开发而生的原生互联终端。
Codux
The high-performance AI coding terminal — desktop, phone, and server, one workspace
Built with Rust + GPUI, Codux unifies Codex, Claude Code, and 9+ AI coding CLIs with live agent status, token analytics, local memory, credential-isolated SSH & database access, and encrypted device links for taking over long-running agent work from anywhere.
Website · Docs · Download · Mobile · Feedback
English | 简体中文 | 日本語 | 한국어
https://github.com/user-attachments/assets/cabf21a9-8649-4e65-9e8a-db27ccaccdf3
▶ Watch the demo
AI coding CLIs are incredibly powerful — and incredibly easy to lose control of. Real work sprawls across projects, Git worktrees, terminals, sessions, tokens, remote shells, and context you half-remember. Codux turns that chaos into one durable, native workspace built for serious AI coding.
| When AI coding gets messy | Codux gives you |
|---|---|
| Every AI CLI has its own state | One project-aware view across Codex, Claude Code, Oh My Pi, OpenCode, Kiro CLI, Kimi Code, CodeWhale, MiMo Code, and Agy. |
| Long agent runs are hard to resume | Live status, local history, session restore, and context that follows each worktree. |
| Parallel tasks collide | A worktree-first model where every task keeps its own terminals, Git state, files, and AI sessions. |
| Token spend is a black box | Usage by tool, model, project, worktree, and day — no spreadsheets. |
| Context evaporates between sessions | Local memory for habits, project profiles, and module notes, injected back into supported CLIs automatically. |
| Credentials end up in prompts | Saved, tested SSH and database profiles, plus codux-ssh / codux-db commands agents can use without ever seeing your credentials. |
| You walk away mid-run | Pair your phone over P2P / relay links and keep driving the session from anywhere. |
| The code lives on another machine | Connect a headless host — a server, spare Mac, or Linux box — and drive its terminals, Git, and AI as if they were local. |
| Your Windows project lives in WSL | Use an installed WSL distribution as a native Codux runtime, keeping files, Git, worktrees, terminals, and AI sessions inside Linux. |
Codux is not another editor. It's the control plane for developers who live in AI coding CLIs and need a rock-solid way to run multi-project, long-running agent work.
macOS — install with Homebrew:
brew install --cask duxweb/tap/coduxcodex, claude, opencode, and friends. The non-invasive wrapper lights up live status, token tracking, and memory injection with zero configuration.On Windows, or without Homebrew: see Download.
Agents constantly need servers and databases — but pasting a password into a prompt, or letting the model read your config files, is exactly how credentials leak. Codux stores connection profiles locally and hands agents two safe commands instead:
codux-ssh — the agent runs codux-ssh list, sees profile names and hosts only, and connects through the wrapper. Passwords and keys are injected inside Codux's helper process; they never enter the model's context, the transcript, or your shell history.codux-db — the same isolation for MySQL / PostgreSQL / SQLite: saved once in Codux, queried by profile name. Read-only profiles are enforced inside the wrapper with a single-statement allowlist, so the model can't escalate its own access.Codux uses non-invasive wrappers and per-tool adapters. It does not write project prompt files or mutate your global AI CLI configuration just to inject Codux context.
| AI CLI | Live status | Token usage | Model setting | Full-access mode | Environment directives |
|---|---|---|---|---|---|
| Codex | ✓ | ✓ | ✓ | ✓ | ✓ via developer instructions |
| Claude Code / reclaude | ✓ | ✓ | ✓ | ✓ | ✓ via --append-system-prompt |
| Oh My Pi | ✓ via native OSC | ✓ | ✓ | ✓ | ✓ via --append-system-prompt |
| OpenCode | ✓ | ✓ | ✓ | ✓ | ✓ via managed plugin config |
| MiMo Code | ✓ | ✓ | ✓ | ✓ | ✓ via managed plugin config |
| Kimi Code | ✓ | ✓ | ✓ | — | ✓ via managed --agent-file |
| Kiro CLI | ✓ | ✓ | ✓ | ✓ | Not injected; no confirmed non-invasive prompt channel |
| CodeWhale | ✓ | ✓ | ✓ | ✓ | Not injected for interactive sessions |
| Agy | ✓ | ✓ | ✓ | ✓ | Not injected; no confirmed non-invasive prompt channel |
Environment directives include Codux memory plus runtime commands such as codux-ssh and codux-db. For unsupported tools, Codux still tracks sessions where possible, but it will not force prompt injection through project files or user-level config.
Beta. Connecting to a headless host ships first as a beta in this release — the connection, pairing, and host-side data flow are still under active testing, so expect rough edges. Feedback is very welcome.
Powered by iroh, desktop, phone, and a headless host all act as peers over end-to-end encrypted P2P / relay links, so you can keep driving long agent runs from anywhere.
flowchart LR
subgraph drivers["You drive from"]
P[" Phone"]
D[" Desktop"]
end
subgraph hosts["Work runs on (the host)"]
D2[" Another desktop"]
H["️ Headless host
server · spare Mac · Linux"]
end
P -->|" P2P / Relay"| D2
P -->|" P2P / Relay"| H
D -->|" P2P / Relay"| D2
D -->|" P2P / Relay"| HAny controller — a desktop or a phone — can connect to any host — another desktop or a headless host. A desktop is both: it hosts its own projects and can drive others; a phone drives only. The work stays on the host machine, so switching devices does not interrupt the session.
codux on a server, spare Mac, or Linux box and drive its terminals, Git, and AI as if they were local. See apps/agent/README.md.Every token your agents burn feeds a pixel pet that lives in your workspace. Hatch it, name it, and watch it level up as you code — its five stats (Wisdom, Chaos, Night, Stamina, Empathy) grow out of how, and when, you actually work. Install custom sprite pets, or retire old companions into your hall of fame.
Completely useless. Absolutely essential.
Desktop app
macOS — install with Homebrew:
brew install --cask duxweb/tap/coduxOr download directly:
| Platform | Download |
|---|---|
| macOS · Apple Silicon | ⬇ codux-macos-aarch64.dmg |
| macOS · Intel | ⬇ codux-macos-x86_64.dmg |
| Windows 11 · x64 | ⬇ codux-windows-x86_64-setup.exe |
Open the macOS .dmg and drag Codux to Applications; double-click the Windows installer. Then open a project, start your AI CLI, and go.
Windows + WSL. Open Settings → WSL to enable the integration, install or select a distribution, and install or update Codux Runtime with one click. When adding a project, choose a directory inside that WSL distribution; Codux then routes its files, Git, worktrees, terminals, and AI sessions through WSL automatically.
Mobile app
Download the Android APK from the latest Codux Mobile release, or get the iOS app on the App Store.
Why is the iOS app paid? Codux is fully open source (GPL-3.0); desktop and Android are free. The iOS price only covers Apple’s $99/year developer fee and revenue cut, and supports ongoing development — no subscriptions, no in-app purchases. Prefer not to pay? Build the identical app yourself from this repo's
apps/mobilesource.
Headless host (codux-agent) — Beta, ships with 2.0
macOS / Linux — one line (auto-detects OS/arch, installs as codux on your PATH):
curl -fsSL https://raw.githubusercontent.com/duxweb/codux/main/apps/agent/scripts/install.sh | shFlags: --beta · --version · --dir · --setup · --mirror (if GitHub is slow where you are) · --uninstall. Or download the binary directly:
| Platform | Download |
|---|---|
| macOS · Apple Silicon | ⬇ codux-macos-aarch64 |
| macOS · Intel | ⬇ codux-macos-x86_64 |
| Linux · arm64 | ⬇ codux-linux-aarch64 |
| Linux · x64 | ⬇ codux-linux-x86_64 |
| Windows · x64 | ⬇ codux-windows-x86_64.exe |
Put the binary on your PATH as codux, then run codux config → codux install → codux qrcode.
Run codux --help for details, or see apps/agent/README.md.
All headless host commands
| Command | What it does |
|---|---|
codux config |
Interactive setup (device name, relay). Writes codux.toml. |
codux install |
Run as a startup service (launchd / systemd --user / Task Scheduler). |
codux start / stop |
Start (foreground) or stop the host. |
codux status |
Whether it's running, node id, and paired-device count. |
codux qrcode / link |
Show the pairing QR / print the pairing ticket to paste on the desktop. |
codux device |
List paired devices; device:del / device:rename / device:clear to manage. |
codux update |
Download, verify, and replace this binary, then restart the host. |
codux uninstall |
Stop and remove the service. |
When you control a paired headless host from Codux Desktop, the globe Web Tunnel Browser button opens a proxy-isolated Chromium that browses as the host: if the host runs Vite at http://127.0.0.1:5173/, type that URL and it opens through the encrypted Codux lin
No open issues yet, or sync has not completed.