Your macOS workstation for AI coding.
Native SwiftUI + AppKit · GPU-accelerated terminal · built for Claude Code, Codex, Gemini CLI, and OpenCode.
Website · Download · Mobile · Relay Service · Feedback
English | 简体中文
 AI Stats & Session Restore |
 Daily Level |
 Built-in Git |
 Pet Companion |
GitHub README does not render third-party iframe players. Watch the demo on Bilibili.
| # | Feature | What it does |
|---|---|---|
| 1 | Live AI Activity | Real-time status + system notifications for every running AI terminal (Claude Code, Codex, Gemini CLI, OpenCode). The tab indicator, project tile, and macOS notification all light up the moment a turn finishes — no more watching the cursor blink. |
| 2 | AI Stats & Session Restore | Token totals split by tool / model / project, daily and trend views, and one-click resume of any past session back into the original tool. Scattered AI runs turn into a usable history. |
| 3 | Daily Level | A daily ladder powered by real token usage. One snapshot tells you what you ran, how much, and how today compares to a normal day — easy to glance at, hard to fudge. |
| 4 | Pet Companion | An optional pet in the title bar that grows with your AI coding habits. It supports Codex-format custom pet imports, so compatible pet.json + spritesheet.png packages can be installed from Petdex, renamed, validated, adopted, archived, and restored alongside the bundled pets. Fully optional, one-click mute. |
| 5 | Built-in Git | A first-class Git panel — not an embedded webview. Branch checkout / create / rename / delete, staging with line-level diffs, full commit history, and push / pull / sync with sane defaults and clear conflict resolution. |
| 6 | Project File Browser | Per-project native file manager. Edit code inline, preview images and other assets, and drag any file straight into the terminal so your AI tool gets the right path on the first try. |
| 7 | Multi-Project Workspaces | Every project is its own room — up to 6 split terminals for parallel work plus unlimited tabs when 6 is not enough. Each project keeps its own layout, sessions, AI tool selection, and state across restarts. |
| 8 | Three-Layer AI Memory | Local memory.sqlite3 extracts long-term memory from completed sessions, layered as user / project / tool. App-private CLAUDE.md, AGENTS.md, GEMINI.md are generated so Codex / Claude / Gemini / OpenCode no longer forget what you did last session — and nothing is written into your repo. |
| 9 | Mobile Handoff | Step away from the Mac and keep going on your phone. Codux Mobile pairs with the Mac host to drive AI CLI sessions remotely with end-to-end encrypted relay traffic. See the Mobile Handoff section below. |
| 10 | Ghostty Engine & Themes | Embeds the ghostty terminal engine for GPU-accelerated rendering, plus a curated set of light / dark themes that follow macOS appearance. |
Codux can import custom companions built with the same flat Codex pet package format: one pet.json manifest plus one spritesheet.png atlas. Open the Petdex marketplace from the pet claim or Petdex flow, paste a Petdex pet page URL, preview the metadata, adjust the display name, and install it into Codux. Installed custom pets appear with the bundled companions and keep the same adoption, archive, restore, animation, bubble, and growth behavior.
Creators can use the Codex pet atlas guide to generate compatible 8 x 9 atlases and package them for import.
Codux Mobile + Codux Service are a separate stack so the relay can be self-hosted while the Mac stays the real terminal host.
| Component | Purpose | Download |
|---|---|---|
| Codux for macOS | Main desktop app: projects, terminals, Git, stats, memory, remote host. | macOS Releases |
| Codux Mobile | Android client: pair with the Mac, run AI CLI sessions remotely, browse files, upload images. | Mobile Releases |
| Codux Service | Lightweight Go relay for device pairing and encrypted WebSocket forwarding. | Service Releases |
For a quick trial, enter one of the official trial relays in Settings > Remote:
| Node | URL |
|---|---|
| China relay direct | https://codux-service.dux.plus |
| Global transit acceleration | https://codux-node.dux.plus |
Terminal input, output, file payloads, project lists, and AI stats are end-to-end encrypted between Codux for macOS and Codux Mobile. The relay sees only routing metadata (host ID, device ID, pairing state, online state) — never decrypted terminal content. For long-term use, self-hosting codux-service is recommended.
brew install --cask duxweb/tap/coduxbrew update
brew upgrade --cask codux- Download the latest release from GitHub Releases or codux.dux.cn
- Drag Codux to your Applications folder
- Open Codux, click New Project, and pick a directory
- Start typing — you're ready to go
"Cannot be opened because the developer cannot be verified"
Since Codux is not yet notarized by Apple, macOS may block the first launch. To fix this:
sudo xattr -rd com.apple.quarantine /Applications/Codux.appOr go to System Settings > Privacy & Security, scroll down and click Open Anyway next to the Codux warning.
| Action | Shortcut |
|---|---|
| New Split | ⌘T |
| New Tab | ⌘D |
| Toggle Git Panel | ⌘G |
| Toggle AI Panel | ⌘Y |
| Switch Project | ⌘1 - ⌘9 |
All shortcuts can be customized in Settings > Shortcuts.
- macOS 14.0 (Sonoma) or later
Found a bug or have a feature request? Open an issue on GitHub.
When reporting a bug, the easiest path is Help -> Export Diagnostics… — save the generated .zip and attach it to your GitHub issue. The archive bundles runtime logs, rotated logs, performance summaries, saved app state, invalid state backups, and any matching macOS crash / hang / spin reports.
If you need to collect logs manually, Codux writes runtime logs to:
~/Library/Application Support/Codux/logs/runtime.log~/Library/Application Support/Codux/logs/runtime.previous.log~/Library/Application Support/Codux/logs/performance-summary.json
Notes:
- Codux clears the previous app session logs on each launch
runtime.previous.logonly appears once the current session log rotatesperformance-summary.jsoncovers recent performance spikes / main-thread stalls
Open the log folder directly:
open ~/Library/Application\ Support/Codux/logsIf the app crashes or hangs right after launch, macOS may write a system crash report to ~/Library/Logs/DiagnosticReports/ (look for Codux-*.ips or dmux-*.ips). Attach the file whose timestamp is closest to the crash.
open ~/Library/Logs/DiagnosticReportsWhen opening an issue, please include: macOS version + Codux version, repro steps, runtime.log, runtime.previous.log (if present), performance-summary.json (if present), and the matching crash report (if any).
Wanted to be dmux, but that name was taken. So it's Codux now, which sounds like "Cool Dux" in Chinese.