The high-performance AI coding terminal — desktop, phone, and server, one workspace
Built with Rust + GPUI, Codux unifies Codex, Claude Code, and 8+ 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 · Contact · Feedback

English | 简体中文 | 日本語 | 한국어

▶ 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.

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/codux

1. Open a project. Git worktrees, project state, and per-project sessions are picked up automatically.
2. Start your AI CLI in the built-in terminal — codex, claude, opencode, and friends. The non-invasive wrapper lights up live status, token tracking, and memory injection with zero configuration.
3. Leave the desk. Pair your phone or a headless host once, then take over the same running session from anywhere.

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.
• Zero per-project setup. Every supported CLI learns about these commands automatically through Codux's environment directives.

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.

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.

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.

• Direct when possible. Codux prefers P2P paths and falls back to relay when the network requires it.
• Not SSH remote desktop. Pair devices once, then connect straight into Codux itself.
• No public IP required. Desktop, phone, and host can pair and reconnect across ordinary home, office, and mobile networks.

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<br/>server · spare Mac · Linux"]
    end
    P -->|"🔒 P2P / Relay"| D2
    P -->|"🔒 P2P / Relay"| H
    D -->|"🔒 P2P / Relay"| D2
    D -->|"🔒 P2P / Relay"| H

Any 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.

• Phone handoff. Pair in seconds and continue the same terminals, history, and AI sessions from your phone.
• Headless host. Run 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.
• Session continuity. Reconnect to the same running shells and agent sessions after disconnects.

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.

• Your data stays yours. Projects, terminals, sessions, memory, token stats, and credentials live on your machines — there is no Codux cloud and no account to sign up for.
• Encrypted device links. Desktop ⇄ phone ⇄ host traffic is end-to-end encrypted; relays only forward ciphertext when a direct P2P path isn't possible.
• Non-invasive by principle. Codux never writes prompt files into your repositories and never mutates your AI CLIs' global configs — all context injection goes through wrappers and per-tool adapters you can inspect.

Desktop app

macOS — install with Homebrew:

brew install --cask duxweb/tap/codux

Or download directly:

Open the macOS .dmg and drag Codux to Applications; double-click the Windows installer. Then open a project, start your AI CLI, and go.

Mobile app

Download from the latest Codux Mobile release.

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 | sh

Flags: --beta · --version <x.y.z> · --dir <path> · --setup · --mirror <prefix> (if GitHub is slow where you are) · --uninstall. Or download the binary directly:

Put the binary on your PATH as codux, then run codux config → codux install → codux qrcode.

Run codux <command> --help for details, or see apps/agent/README.md.

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 link — HTTPS, WebSocket, HMR, LAN addresses, .local names, and VPN routes included.

Customize everything in Settings → Shortcuts.

Desktop app

• macOS 14.0 (Sonoma) or later
• Windows 11

Headless host (codux-agent)

• macOS, Linux, and Windows (x86_64 and arm64)

Found a bug or have a feature request? Open an issue on GitHub.

For bug reports, use Help → Export Diagnostics and attach the generated .zip — it bundles runtime logs, rotated logs, performance summaries, saved app state, invalid-state backups, and matching macOS diagnostic reports when available.

Manual log paths:

• ~/Library/Application Support/Codux/logs/runtime-rust.log
• ~/Library/Application Support/Codux/logs/performance-summary.json
• %APPDATA%\Codux\logs\runtime-rust.log

Codux recognizes and supports the LINUX DO community.

Thanks to everyone who has contributed code, issues, testing, and feedback to Codux.

Add the author on WeChat, or buy the author a coffee.

If Codux ever rescued one of your long agent runs, a ⭐ helps more people find it.

Wanted to be dmux, but that name was taken. So it's Codux now — which sounds like "Cool Dux" in Chinese.

codux.dux.cn