Dux AI工作流终端

Prerequisites

• git — dux is built around git worktrees, so git is non-negotiable. If it's not on your PATH, dux won't get very far.
• gh CLI (optional) — authenticate it with your GitHub account and dux can pull PR statuses, check details, and show them right in the interface. Not required, but you'll miss it once you've tried it.

Install

Homebrew (macOS and Linux):

On macOS, Homebrew is the preferred route. This command taps the source and installs dux in one shot, because life's too short for a two-command install:

brew install patrickdappollonio/tap/dux

npm:

Install dux globally so the CLI lands on your PATH. Installing it as a dependency of some random project technically works, but that's not where terminal apps go to be useful:

npm install -g @patrickdappollonio/dux
dux

For a one-off run without keeping it around:

npx -y @patrickdappollonio/dux

Shell (all platforms):

The install script sniffs out your operating system and architecture, then grabs the matching release archive. No guessing which tarball has your name on it:

curl -sSfL https://github.com/patrickdappollonio/dux/releases/latest/download/install.sh | bash

By default, the script installs to ~/.local/bin if it exists and is in your PATH, otherwise /usr/local/bin. You can override the install directory or pin a specific version:

```bash

Custom install directory

curl -sSfL https://github.com/patrickdappollonio/dux/releases/latest/download/install.sh | DUX_INSTALL_DIR=~/.bin bash

Configuration

The config file at ~/.config/dux/config.toml (Linux) or ~/.dux/config.toml (macOS) is exhaustively commented. Every setting is explained inline, so you should never need to leave the file to understand an option. Every keybinding is rebindable. Every pane width, scrollback limit, default provider, and startup agent reopening behavior is configurable.

dux config path          # Print the config file path
dux config diff          # Show what you've changed from defaults
dux config diff --raw    # Unified diff against the default config
dux config reset         # Remove config and logs (keeps agents)
dux config reset --all   # Full factory reset
dux config regenerate    # Preview a fresh default config

Override the config directory with the DUX_HOME environment variable.

Git Integration

The right pane is a full git staging area. Stage and unstage files, view syntax-highlighted diffs, write commit messages, push, and pull, all without leaving dux.

AI commit messages: Stage your changes, hit a key, and dux sends the diff to your provider in oneshot mode. It drafts a commit message using Conventional Commits, you tweak it (or don't), and commit. The prompt is customizable once in config.toml for the whole app.

PR tracking: With the gh CLI installed, dux tracks pull requests for your agent branches and shows status pills right in the interface.