Commander

Commander is a native Tauri v2 desktop app that orchestrates multiple CLI coding agents against any Git project. It keeps every workflow local, manages agent workspaces with Git worktrees, and wraps advanced Git + filesystem automation inside a React/Vite interface.

What Works Today

• Multi-agent chat surface for Claude Code CLI, OpenAI Codex CLI, Gemini CLI, and a local test harness – each with live streaming, plan mode, and parallel session tracking.
• Workspace-aware execution that spins up Git worktrees under .commander/ so every agent operates in an isolated branch without touching your main tree.
• Project lifecycle management: clone repos with progress streaming, validate Git remotes, open existing repositories, and persist a capped MRU list with branch/status metadata.
• Deep Git tooling: commit DAG visualization, diff viewer, branch/worktree selectors, and Git config/alias inspection exposed through the Tauri commands layer.
• Persistent chat history, provider settings, execution modes, and prompts stored locally via tauri-plugin-store, so every project resumes exactly where you left off.
• Settings modal backed by tests for loading/saving provider configuration, global system prompt management, agent enablement, and automatic CLI detection feedback.
• Shadcn/ui-based desktop interface with file mentions, autocomplete for slash (/) and at (@) commands, rotating prompts, and a session control bar for replaying or clearing runs.

Requirements

• macOS (Apple Silicon or Intel) or Windows 11 with Git installed and on the PATH.
• Rust stable toolchain + Cargo.
• Bun (preferred) or Node.js 18+.
• CLI agents you want to use:
  • Claude Code CLI
  • OpenAI Codex CLI
  • Google Gemini CLI
  • (Optional) GitHub CLI for repo metadata in the sidebar.

Quick Start

1. Install dependencies: bun install
2. Launch the desktop app: bun tauri dev
3. Point Commander at an existing Git repository or use the clone flow from the project launcher.
4. Start a chat with /claude, /codex, or /gemini – Commander will stream output, create worktrees when needed, and persist the conversation per project.

Agent Setup Cheatsheet

# Claude Code CLI
npm install -g @anthropic-ai/claude-code
claude  # run once and authenticate with /login inside the shell

# OpenAI Codex CLI
npm install -g @openai/codex
codex  # follow the interactive auth flow

# Gemini CLI
npm install -g @google/gemini-cli@latest
# or follow the official docs for your platform

Commander detects installed CLIs on launch and surfaces their status in Settings → LLM Providers. Disabled agents can be toggled per-session; missing installs display remediation tips.

Settings Schema Updates

The app auto-migrates settings on load. Recent changes introduced the following keys and behaviors:

• app_settings.code_settings.show_file_explorer (boolean, default: true)
  • Controls visibility of the Code view File Explorer panel. If missing, the app assumes true and persists it on next save.
• Recent Projects are deduplicated by path during load; the cleaned list is written back to recent-projects.json.

No manual action required — existing ~/.commander/settings.json is upgraded automatically when the app runs.