Getting Started
Codux is a native terminal built around your AI coding CLIs — Codex, Claude Code, OpenCode, Kiro, CodeWhale, Kimi Code, MiMo-Code, Agy, and more over time. It launches the CLIs you already have installed; it does not bundle them. This page takes you from zero to your first project terminal.
1. Install Codux
Section titled “1. Install Codux”On macOS:
brew install --cask duxweb/tap/coduxOn Windows, download codux-windows-x86_64-setup.exe from GitHub Releases and run it.
Package options, system requirements, first-launch notes, and the built-in updater are covered in Installation & Updates.
2. Open your first project
Section titled “2. Open your first project”Launch Codux and click New Project on the welcome screen (or Open Project for an existing folder). A project gets its own terminals, file browser, Git panel, and AI session history.
3. Launch your AI CLI
Section titled “3. Launch your AI CLI”Open a terminal in the project and start the CLI you already use — codex, claude, opencode, or any of the others. Codux picks it up automatically: live status appears in the sidebar, and tokens start counting in AI Stats.
Next steps
Section titled “Next steps”- Read the Feature overview to see what Codux gives you out of the box.
- Learn the Keyboard shortcuts.
- Save SSH and database profiles so the AI can reach your servers without seeing credentials.
- Pair your phone via Phone Handoff to keep working away from the desk.