feat: add Cursor CLI (agent) support

Add Cursor as a supported agent using the new centralized registry.
Cursor CLI is built on Claude Code's codebase, so status detection
delegates to the existing Claude detector.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: covlllp

README.md

@@ -24,7 +24,7 @@ Run multiple AI agents in parallel across different branches of your codebase, e
 
 ## Features
 
-- **Multi-agent support** -- Claude Code, OpenCode, Mistral Vibe, Codex CLI, and Gemini CLI
+- **Multi-agent support** -- Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, and Cursor CLI
 - **TUI dashboard** -- visual interface to create, monitor, and manage sessions
 - **Agent + terminal views** -- toggle between your AI agents and paired shell terminals with `t`
 - **Status detection** -- see which agents are running, waiting for input, or idle
@@ -95,7 +95,7 @@ Nothing. Sessions are tmux sessions running in the background. Open and close `a
 
 ### Which AI tools are supported?
 
-Claude Code, OpenCode, Mistral Vibe, Codex CLI, and Gemini CLI. AoE auto-detects which are installed on your system.
+Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, and Cursor CLI. AoE auto-detects which are installed on your system.
 
 ## Troubleshooting
 

docs/cli/reference.md

@@ -43,7 +43,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.
 
@@ -87,7 +87,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

docs/guides/configuration.md

@@ -41,7 +41,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
 ```
 
 | Option | Default | Description |

docs/guides/repo-config.md

@@ -40,7 +40,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
 

docs/guides/sandbox.md

@@ -2,7 +2,7 @@
 
 ## 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
@@ -84,7 +84,7 @@ 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:
 
@@ -187,7 +187,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
@@ -212,7 +212,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/quick-start.md

@@ -68,6 +68,7 @@ aoe add -c opencode .
 aoe add -c vibe .
 aoe add -c codex .
 aoe add -c gemini .
+aoe add -c cursor .
 ```
 
 In the TUI, select the tool from the dropdown in the new session dialog.

src/agents.rs

@@ -110,6 +110,18 @@ pub const AGENTS: &[AgentDef] = &[
         detect_status: status_detection::detect_gemini_status,
         container_env: &[],
     },
+    AgentDef {
+        name: "cursor",
+        binary: "agent",
+        aliases: &[],
+        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,
+        container_env: &[],
+    },
 ];
 
 /// Look up an agent by canonical name.
@@ -174,6 +186,7 @@ mod tests {
         assert_eq!(get_agent("vibe").unwrap().binary, "vibe");
         assert_eq!(get_agent("codex").unwrap().binary, "codex");
         assert_eq!(get_agent("gemini").unwrap().binary, "gemini");
+        assert_eq!(get_agent("cursor").unwrap().binary, "agent");
     }
 
     #[test]
@@ -184,7 +197,10 @@ mod tests {
     #[test]
     fn test_agent_names() {
         let names = agent_names();
-        assert_eq!(names, vec!["claude", "opencode", "vibe", "codex", "gemini"]);
+        assert_eq!(
+            names,
+            vec!["claude", "opencode", "vibe", "codex", "gemini", "cursor"]
+        );
     }
 
     #[test]
@@ -194,19 +210,23 @@ mod tests {
         assert_eq!(resolve_tool_name("mistral-vibe"), Some("vibe"));
         assert_eq!(resolve_tool_name("codex"), Some("codex"));
         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("unknown-tool"), None);
+        assert_eq!(resolve_tool_name("agent"), None);
     }
 
     #[test]
     fn test_settings_index_roundtrip() {
         assert_eq!(settings_index_from_name(None), 0);
         assert_eq!(settings_index_from_name(Some("claude")), 1);
         assert_eq!(settings_index_from_name(Some("gemini")), 5);
+        assert_eq!(settings_index_from_name(Some("cursor")), 6);
 
         assert_eq!(name_from_settings_index(0), None);
         assert_eq!(name_from_settings_index(1), Some("claude"));
         assert_eq!(name_from_settings_index(5), Some("gemini"));
+        assert_eq!(name_from_settings_index(6), Some("cursor"));
         assert_eq!(name_from_settings_index(99), None);
     }
 

src/cli/add.rs

@@ -22,7 +22,7 @@ pub struct AddArgs {
     #[arg(short = 'g', long)]
     group: Option<String>,
 
-    /// Command to run (e.g., 'claude', 'opencode', 'vibe', 'codex', 'gemini')
+    /// Command to run (e.g., 'claude', 'opencode', 'vibe', 'codex', 'gemini', 'cursor')
     #[arg(short = 'c', long = "cmd")]
     command: Option<String>,
 

src/tmux/status_detection.rs

@@ -403,6 +403,10 @@ pub fn detect_codex_status(raw_content: &str) -> Status {
     Status::Idle
 }
 
+pub fn detect_cursor_status(content: &str) -> Status {
+    detect_claude_status(content)
+}
+
 pub fn detect_gemini_status(raw_content: &str) -> Status {
     let content = raw_content.to_lowercase();
     let lines: Vec<&str> = content.lines().collect();
@@ -704,6 +708,44 @@ mod tests {
         assert_eq!(detect_codex_status("random output text"), Status::Idle);
     }
 
+    #[test]
+    fn test_detect_cursor_status_running() {
+        assert_eq!(
+            detect_cursor_status("Working on your request (esc to interrupt)"),
+            Status::Running
+        );
+        assert_eq!(detect_cursor_status("Processing ⠋"), Status::Running);
+    }
+
+    #[test]
+    fn test_detect_cursor_status_waiting() {
+        assert_eq!(detect_cursor_status("Yes, allow once"), Status::Waiting);
+        assert_eq!(detect_cursor_status("Task complete.\n>"), Status::Waiting);
+    }
+
+    #[test]
+    fn test_detect_cursor_status_idle() {
+        assert_eq!(detect_cursor_status("some random output"), Status::Idle);
+    }
+
+    #[test]
+    fn test_detect_cursor_status_delegates_to_claude() {
+        // Cursor CLI is built on Claude Code, so all Claude patterns should work
+        let test_cases = vec![
+            ("Thinking... · esc to interrupt", Status::Running),
+            ("Do you trust the files in this folder?", Status::Waiting),
+            ("completed the task", Status::Idle),
+        ];
+        for (content, expected) in test_cases {
+            assert_eq!(
+                detect_cursor_status(content),
+                expected,
+                "Failed for: {}",
+                content
+            );
+        }
+    }
+
     #[test]
     fn test_detect_gemini_status_running() {
         assert_eq!(

src/tui/mod.rs

@@ -70,6 +70,7 @@ pub async fn run(profile: &str) -> Result<()> {
         eprintln!("Agent of Empires requires at least one of:");
         eprintln!("  claude    - Anthropic's Claude CLI");
         eprintln!("  opencode  - OpenCode CLI");
+        eprintln!("  cursor    - Cursor's Agent CLI");
         eprintln!();
         eprintln!("Install one of these tools and ensure it's in your PATH.");
         std::process::exit(1);