Codux Codux AI
Native Rust + GPUI · 8 AI coding CLIs · Phone handoff

Codux AI
The native terminal for AI coding agents

Run Codex, Claude Code, Gemini CLI, OpenCode, Kiro CLI, Kimi Code, CodeWhale, and Agy in one project-aware terminal — with live agent state, token analytics, durable memory, worktrees, agent-safe SSH, and phone handoff.

Download Codux Mobile companion Read the docs
  • macOS + Windows 11
  • Android + iOS
  • Local-first memory & stats
Codux app showcase — desktop workspace and mobile companion
8
AI coding CLIs in one place
Native
Rust + GPUI, not Electron
Local
Memory & stats stay on device
Iroh
Phone-to-desktop handoff
01 Capabilities

Everything around your AI CLI sessions

Codux is not another editor. It is the native control surface for the AI coding tools, worktrees, and secure connections you already run.

Every AI CLI, one place

Deep, first-class support for each AI coding tool you run.

  • Live agent state

    Codex, Claude Code, Gemini CLI, OpenCode, Kiro CLI, Kimi Code, CodeWhale, and Agy report running, completed, and needs-input status in one view.

  • History & token stats

    Track usage by tool, model, project, worktree, and day, then resume previous work in the right CLI context.

  • More tools over time

    New AI CLIs and secure connectors are added with the same first-class support, not one-off bolt-ons.

Worktree-first workspace

Projects, task worktrees, files, Git, and splits stay tied together.

  • Task layout restore

    Each worktree keeps its terminal layout, active tabs, files, Git state, and AI session surface independent.

  • Project file browser

    Browse, preview, and edit project files, then send the right path or image context into a terminal.

  • Built-in Git

    Clone, branch, stage, diff, review history, push, pull, and sync without leaving the AI CLI workflow.

Durable local memory

Useful context grows without polluting your repository.

  • Three-layer memory

    User habits, project overview, and project notes are stored in local SQLite and rendered into launch files outside your repo.

  • Token-aware recall

    Recent notes and project memory are selected under token budgets so injection stays useful instead of bloated.

Mobile & secure flow

Keep the workspace available from desk to phone and server.

  • Phone handoff over Iroh

    Codux Mobile pairs with a short-lived code, takes a direct peer-to-peer path when it can, and falls back to a relay you simply select.

  • Agent-safe SSH

    Run remote commands through saved SSH profiles with codux-ssh — your passwords and keys are never exposed to the AI CLI.

02 Architecture

Memory and remote transport stay explicit

Local SQLite memory rendered into launch files, and phone-to-desktop handoff over the Iroh transport — kept in clear, inspectable layers.

Three-layer memory rendered at launch

Codux stores durable memory in local SQLite, separates user habits from project knowledge, and keeps recent working notes under an injection budget. When a CLI starts, Codux renders app-private memory and tool entry files outside your repository — your repo is never touched.

01
User memory
Across projects

Coding habits, response preferences, and durable personal workflow rules

02
Project overview
Per repository

What the project does, tech stack, modules, commands, and source signals

03
Project notes
Evolving over time

Decisions, conventions, bug lessons, and recent notes selected by relevance

Pair over Iroh, direct path when possible

Codux Mobile pairs with the desktop over the Iroh transport using a short-lived pairing code. It takes a direct peer-to-peer path when the network allows and falls back to a relay otherwise. The relay is a simple choice in settings — Global, a China node, or your own — there is no address to copy around. The desktop always stays the real terminal host.

DESKTOP
Codux Desktop
The real terminal host
RELAY
Iroh transport
Direct P2P, relay fallback
MOBILE
Codux Mobile
Android and iOS companion
  • Pairing starts from a short-lived code
  • Direct peer-to-peer when available
  • End-to-end encrypted payload
  • Pick a relay node — no address to manage

The relay only helps the two devices find each other and carries traffic when a direct path is unavailable. It never becomes the desktop host and never sees your decrypted data.

03 Who it's for

Built for developers who live in AI coding CLIs

When one model is not enough and one terminal is too little, Codux gives the workflow a home.

Heavy AI CLI users

You switch between Codex, Claude Code, Gemini CLI, OpenCode, Kiro CLI, Kimi Code, CodeWhale, and Agy. Codux gives them one project-aware home with shared context, session history, live status, and usage stats.

Worktree task workers

Projects, worktrees, terminals, files, Git state, and AI sessions stay tied together so each task has its own restored workspace.

Privacy-minded teams

Memory and stats stay local by default. Launch files are generated in app-private storage, never committed into your repository.

Secure connection users

Run remote commands through saved SSH profiles with codux-ssh — your passwords and keys are never exposed to the AI CLI.

04 Mobile

Leave the desk without losing the session

Codux Mobile drives your desktop host over Iroh: a direct peer-to-peer path when it can, with a relay fallback you simply select.

Codux Desktop

The native app for projects, terminals, Git, AI stats, memory, and remote hosting on your workstation.

Desktop Releases

Codux Mobile

Android and iOS companion for paired terminals, file browsing, text edits, image uploads, and AI stats.

Mobile Releases

Relay (optional)

Helps the phone and desktop connect over Iroh when a direct path is unavailable. Just choose a node in settings — Global, a China node, or your own.

Relay Guide
Global Default
China (Tencent / Aliyun) Built-in
Custom Your own node
05 Quick Start

Install, add a project, start a CLI

Download the latest release, open a project, and launch your AI CLI from the project context.

~ codux 
$ brew install --cask duxweb/tap/codux
  1. 1 Install the cask with one command above when you are on macOS.
  2. 2 Launch Codux, click New Project, and pick a repository directory.
  3. 3 Start a terminal split and launch your preferred AI CLI from the project context.
Community

Add the author on WeChat

Scan the QR code, add a short Codux note, and ask to join the DUXAI community group.

The QR code is maintained from the Dux AI community page.

Author WeChat QR code
06 FAQ

Straight answers before you try it

How Codux fits beside terminals, editors, privacy rules, and mobile work.

How is this different from Warp / iTerm2 + many CLIs?
Warp and iTerm2 are great terminals; Codux is a workspace built on top. You get project-aware terminals, live agent state, a native Git panel, AI usage stats and session restore across tools, and durable local memory — without leaving the terminal.
Does Codux upload my code or AI conversations?
No by default. Memory and stats live in the app data directory. Nothing leaves the workstation unless you configure an AI provider, use a CLI that calls its own cloud service, or explicitly pair a phone.
Can I disable the pet?
Yes — one click in Settings. The pet is opt-in by design.
How does the mobile connection actually work?
Codux Mobile pairs with the desktop over the Iroh transport using a short-lived pairing code. It prefers a direct peer-to-peer path and falls back to a relay you select (Global, a China node, or your own). The desktop stays the real terminal host.
How does Codux compare to Cursor / VS Code?
They're editor-first; Codux is terminal-first and native (Rust + GPUI, the same stack as Zed). It pairs naturally with whichever editor you already use — it doesn't replace it.
Which AI CLIs are supported?
Codex, Claude Code, Gemini CLI, OpenCode, Kiro CLI, Kimi Code, CodeWhale, and Agy today — each with deep, first-class support for live status, history, and memory. More are added over time.
Which platforms are supported?
macOS 14+ and Windows 11 on desktop, with Android and iOS as the mobile companion. Desktop and mobile share one native terminal core.
Ready when you are

Give every AI coding agent one native home

Open source, local-first, built for multi-project AI coding on desktop and mobile.

Download Star on GitHub