CC-GUI v0.1.0

CC-GUI is a desktop app for claude-commander — manage your Claude coding sessions from a native window instead of the terminal TUI. It embeds claude-commander directly, so it drives the same tmux-backed sessions and stays in sync with the CLI.

This is the first release. Feedback and contributions welcome.

Highlights

• Session management — sessions grouped by project / section / stack, with liveness and unread indicators; rename, restart, kill, delete, and "restart fresh".
• Embedded terminals — attach to any session in a real PTY (xterm.js); attaching recreates stopped sessions.
• Code review — read-only diff view with inline comments you can stage and apply back to the agent.
• Project shells & cascade — open a shell in any project/worktree; merge, resume, abandon, and push stacked sessions.
• Theming — 10 built-in themes plus your own custom themes, with a live-preview picker. (authoring guide)
• Command palette (Cmd/Ctrl+K) — fuzzy-jump to a session or run any command.

Requirements

• macOS (Apple Silicon) for the packaged app
• Rust toolchain, Node.js, tmux, and the claude CLI

claude-commander itself is a pinned git dependency — Cargo fetches it automatically, no separate checkout needed.

Getting started

git clone git@github.com:Ed-Barnes937/CC-GUI.git
cd CC-GUI
npm install
npm run app:install   # build + install to /Applications (macOS)

Or run it in development with npm run tauri dev. See the README for the full setup and keyboard reference, and CONTRIBUTING.md to hack on it.

Under the hood

• Tauri 2 — Rust backend + TypeScript/Vite frontend
• Reproducible builds (claude-commander pinned to a release tag)
• CI on every PR: type-check, build, rustfmt, clippy, and a frontend test suite (unit + isolated whole-frontend tests)

Known limitations

• Packaged builds are unsigned and Apple-Silicon only — Gatekeeper will warn on machines that didn't build it, and there's no Intel/Linux bundle yet. Building from source works on any platform Tauri supports.