add cursor cli

Author: njbrake

docker/Dockerfile

@@ -1,5 +1,5 @@
 # aoe-sandbox: Docker image for Agent of Empires sandbox sessions
-# This image provides Claude Code, OpenCode, Mistral Vibe, Codex CLI, and Gemini CLI in an isolated environment
+# This image provides Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, and Cursor CLI in an isolated environment
 
 FROM ubuntu:24.04
 
@@ -47,13 +47,17 @@ RUN npm install -g @google/gemini-cli
 RUN curl -LsSf https://mistral.ai/vibe/install.sh | bash
 ENV PATH="/root/.vibe/bin:${PATH}"
 
+# Install Cursor CLI
+RUN curl -fsSL https://cursor.com/install | bash
+
 # Create directories for credential mounts
 RUN mkdir -p /root/.claude \
     /root/.config/opencode \
     /root/.local/share/opencode \
     /root/.vibe \
     /root/.codex \
     /root/.gemini \
+    /root/.cursor \
     /root/.ssh
 
 # Allow Claude Code to use --dangerously-skip-permissions as root

docs/guides/sandbox.md

@@ -188,7 +188,7 @@ AOE provides two official sandbox images:
 
 | Image | Description |
 |-------|-------------|
-| `ghcr.io/njbrake/aoe-sandbox:latest` | Base image with Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, git, ripgrep, fzf |
+| `ghcr.io/njbrake/aoe-sandbox:latest` | Base image with Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Cursor CLI, git, ripgrep, fzf |
 | `ghcr.io/njbrake/aoe-dev-sandbox:latest` | Extended image with additional dev tools |
 
 ### Dev Sandbox Tools
@@ -213,7 +213,7 @@ default_image = "ghcr.io/njbrake/aoe-dev-sandbox:latest"
 
 ## Custom Docker Images
 
-The default sandbox image includes Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, git, and basic development tools. For projects requiring additional dependencies beyond what the dev sandbox provides, you can extend either base image.
+The default sandbox image includes Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Cursor CLI, git, and basic development tools. For projects requiring additional dependencies beyond what the dev sandbox provides, you can extend either base image.
 
 ### Step 1: Create a Dockerfile
 

docs/index.md

@@ -10,7 +10,7 @@ AoE lets you run multiple AI agents in parallel -- each in its own tmux session,
 
 ## Why AoE?
 
-**The problem:** You're working with AI coding agents (Claude Code, OpenCode, Codex, etc.) and want to run several in parallel across different tasks or branches. Managing multiple terminal windows, git branches, and container lifecycles by hand gets tedious fast.
+**The problem:** You're working with AI coding agents (Claude Code, OpenCode, Cursor, Codex, etc.) and want to run several in parallel across different tasks or branches. Managing multiple terminal windows, git branches, and container lifecycles by hand gets tedious fast.
 
 **AoE handles it for you:**
 
@@ -22,7 +22,7 @@ AoE lets you run multiple AI agents in parallel -- each in its own tmux session,
 
 ## Supported Agents
 
-Claude Code, OpenCode, Mistral Vibe, Codex CLI, and Gemini CLI. AoE auto-detects which are installed.
+Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, and Cursor CLI. AoE auto-detects which are installed.
 
 <div class="cta-box">
 <p><strong>Ready to get started?</strong></p>

src/agents.rs

@@ -113,10 +113,10 @@ pub const AGENTS: &[AgentDef] = &[
     AgentDef {
         name: "cursor",
         binary: "agent",
-        aliases: &[],
-        detection: DetectionMethod::RunWithArg("agent", "--version"),
-        yolo: Some(YoloMode::CliFlag("--force")),
-        instruction_flag: Some("--append-system-prompt {}"),
+        aliases: &["agent"],
+        detection: DetectionMethod::Which("agent"),
+        yolo: Some(YoloMode::CliFlag("--yolo")),
+        instruction_flag: None,
         set_default_command: false,
         supports_host_launch: true,
         detect_status: status_detection::detect_cursor_status,
@@ -212,8 +212,8 @@ mod tests {
         assert_eq!(resolve_tool_name("gemini"), Some("gemini"));
         assert_eq!(resolve_tool_name("cursor"), Some("cursor"));
         assert_eq!(resolve_tool_name(""), Some("claude"));
+        assert_eq!(resolve_tool_name("agent"), Some("cursor"));
         assert_eq!(resolve_tool_name("unknown-tool"), None);
-        assert_eq!(resolve_tool_name("agent"), None);
     }
 
     #[test]

src/cli/add.rs

@@ -167,8 +167,14 @@ pub async fn run(profile: &str, args: AddArgs) -> Result<()> {
     }
 
     if let Some(cmd) = &args.command {
-        instance.command = cmd.clone();
-        instance.tool = detect_tool(cmd)?;
+        let tool_name = detect_tool(cmd)?;
+        instance.tool = tool_name;
+        // Only store a custom command when the user passed extra args
+        // (e.g. "claude --resume xyz"). A bare tool name/alias should resolve
+        // through the agent definition so the correct binary is used.
+        if cmd.trim().contains(' ') {
+            instance.command = cmd.clone();
+        }
     }
 
     if let Some(worktree_info) = worktree_info_opt {

website/src/pages/docs/cli/reference.md

@@ -47,7 +47,7 @@ This document contains the help content for the `aoe` command-line program.
 
 ## `aoe`
 
-Agent of Empires (aoe) is a terminal session manager that uses tmux to help you manage and monitor AI coding agents like Claude Code and OpenCode.
+Agent of Empires (aoe) is a terminal session manager that uses tmux to help you manage and monitor AI coding agents like Claude Code, OpenCode, and Cursor CLI.
 
 Run without arguments to launch the TUI dashboard.
 
@@ -91,7 +91,7 @@ Add a new session
 
 * `-t`, `--title <TITLE>` -- Session title (defaults to folder name)
 * `-g`, `--group <GROUP>` -- Group path (defaults to parent folder)
-* `-c`, `--cmd <COMMAND>` -- Command to run (e.g., 'claude', 'opencode', 'vibe', 'codex', 'gemini')
+* `-c`, `--cmd <COMMAND>` -- Command to run (e.g., 'claude', 'opencode', 'vibe', 'codex', 'gemini', 'cursor')
 * `-P`, `--parent <PARENT>` -- Parent session (creates sub-session, inherits group)
 * `-l`, `--launch` -- Launch the session immediately after creating
 * `-w`, `--worktree <WORKTREE_BRANCH>` -- Create session in a git worktree for the specified branch

website/src/pages/docs/guides/configuration.md

@@ -45,7 +45,7 @@ All settings below can also be edited from the TUI settings screen (press `s` or
 
 ```toml
 [session]
-default_tool = "claude"   # claude, opencode, vibe, codex, gemini
+default_tool = "claude"   # claude, opencode, vibe, codex, gemini, cursor
 yolo_mode_default = false
 ```
 

website/src/pages/docs/guides/repo-config.md

@@ -44,7 +44,7 @@ For sandboxed sessions, hooks run inside the Docker container.
 default_tool = "opencode"   # Override the default agent for this repo
 ```
 
-Available tools: `claude`, `opencode`, `vibe`, `codex`, `gemini`.
+Available tools: `claude`, `opencode`, `vibe`, `codex`, `gemini`, `cursor`.
 
 ### Sandbox
 

website/src/pages/docs/guides/sandbox.md

@@ -6,7 +6,7 @@ description: Run AI coding agents in isolated Docker containers with Agent of Em
 
 ## Overview
 
-Docker sandboxing runs your AI coding agents (Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI) inside isolated Docker containers while maintaining access to your project files and credentials.
+Docker sandboxing runs your AI coding agents (Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Cursor CLI) inside isolated Docker containers while maintaining access to your project files and credentials.
 
 **Key Features:**
 - One container per session
@@ -88,11 +88,11 @@ environment = ["ANTHROPIC_API_KEY"]
 
 ### Shared Agent Config Directories
 
-AOE shares your host agent credentials with sandboxed containers so agents can authenticate without re-login. This works for all supported agents: Claude Code, OpenCode, Codex, Gemini, and Vibe.
+AOE shares your host agent credentials with sandboxed containers so agents can authenticate without re-login. This works for all supported agents: Claude Code, OpenCode, Codex, Gemini, Vibe, and Cursor.
 
 Rather than bind-mounting your actual host config directories (which would let container writes modify your host files), AOE creates a **shared sandbox directory** per agent:
 
-1. For each agent whose host config directory exists (e.g. `~/.claude/`, `~/.codex/`, `~/.gemini/`, `~/.local/share/opencode/`, `~/.vibe/`), AOE syncs credential files into a shared sandbox directory.
+1. For each agent whose host config directory exists (e.g. `~/.claude/`, `~/.codex/`, `~/.gemini/`, `~/.local/share/opencode/`, `~/.vibe/`, `~/.cursor/`), AOE syncs credential files into a shared sandbox directory.
 2. The sandbox directory is mounted read-write into **all** containers that use that agent.
 3. Containers can read credentials and write runtime state freely without affecting your host config.
 4. In-container changes (e.g. permission approvals, settings tweaks) persist across sessions since all containers share the same directory.
@@ -121,6 +121,7 @@ If an agent's config directory doesn't exist on the host (e.g. you haven't insta
 ~/.gemini/sandbox/                    # Gemini (shared by all containers)
 ~/.local/share/opencode/sandbox/      # OpenCode (shared by all containers)
 ~/.vibe/sandbox/                      # Vibe (shared by all containers)
+~/.cursor/sandbox/                    # Cursor (shared by all containers)
 ```
 
 Deleting an agent's config directory (e.g. `rm -rf ~/.codex/`) removes everything related to that agent, including the sandbox directory. To reset just the sandbox state for an agent, delete its `sandbox/` subdirectory (e.g. `rm -rf ~/.claude/sandbox/`) -- it will be re-created on the next session start.
@@ -141,7 +142,7 @@ Example: `aoe-sandbox-a1b2c3d4`
 
 1. **Session Creation:** When you add a sandboxed session, aoe records the sandbox configuration
 2. **Container Start:** When you start the session, aoe creates/starts the Docker container with appropriate volume mounts
-3. **tmux + docker exec:** Host tmux runs `docker exec -it <container> <tool>` (claude, opencode, vibe, codex, or gemini)
+3. **tmux + docker exec:** Host tmux runs `docker exec -it <container> <tool>` (claude, opencode, vibe, codex, gemini, or cursor)
 4. **Cleanup:** When you remove the session, the container is automatically deleted
 
 
@@ -191,7 +192,7 @@ AOE provides two official sandbox images:
 
 | Image | Description |
 |-------|-------------|
-| `ghcr.io/njbrake/aoe-sandbox:latest` | Base image with Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, git, ripgrep, fzf |
+| `ghcr.io/njbrake/aoe-sandbox:latest` | Base image with Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Cursor CLI, git, ripgrep, fzf |
 | `ghcr.io/njbrake/aoe-dev-sandbox:latest` | Extended image with additional dev tools |
 
 ### Dev Sandbox Tools
@@ -216,7 +217,7 @@ default_image = "ghcr.io/njbrake/aoe-dev-sandbox:latest"
 
 ## Custom Docker Images
 
-The default sandbox image includes Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, git, and basic development tools. For projects requiring additional dependencies beyond what the dev sandbox provides, you can extend either base image.
+The default sandbox image includes Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Cursor CLI, git, and basic development tools. For projects requiring additional dependencies beyond what the dev sandbox provides, you can extend either base image.
 
 ### Step 1: Create a Dockerfile
 

website/src/pages/docs/index.md

@@ -14,7 +14,7 @@ AoE lets you run multiple AI agents in parallel -- each in its own tmux session,
 
 ## Why AoE?
 
-**The problem:** You're working with AI coding agents (Claude Code, OpenCode, Codex, etc.) and want to run several in parallel across different tasks or branches. Managing multiple terminal windows, git branches, and container lifecycles by hand gets tedious fast.
+**The problem:** You're working with AI coding agents (Claude Code, OpenCode, Cursor, Codex, etc.) and want to run several in parallel across different tasks or branches. Managing multiple terminal windows, git branches, and container lifecycles by hand gets tedious fast.
 
 **AoE handles it for you:**
 
@@ -26,4 +26,4 @@ AoE lets you run multiple AI agents in parallel -- each in its own tmux session,
 
 ## Supported Agents
 
-Claude Code, OpenCode, Mistral Vibe, Codex CLI, and Gemini CLI. AoE auto-detects which are installed.
+Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, and Cursor CLI. AoE auto-detects which are installed.