AgentsFirst-class

Cursor Agent

Name: Watchfire
Author: Watchfire

Cursor's headless agent CLI — distinct from the in-editor agent.

docs.cursor.com/cli

What is Cursor Agent?

Cursor Agent CLI is the headless command-line companion to the Cursor editor. It runs autonomously via `cursor-agent --workspace ... --print` and reuses auth and config from `~/.cursor/`. It is distinct from the interactive agent inside the Cursor editor.

Cursor Agent + Watchfire

Watchfire gives each Cursor Agent session its own home under `~/.watchfire/cursor-home/<project_id>/<session_id>/` and symlinks the real `~/.cursor/` auth and config files into it. The composed Watchfire system prompt is installed as `AGENTS.md` in the session home, and sessions launch headless with the yolo / trust flag behind the Watchfire sandbox.

Symlinks `~/.cursor/` auth/config files into the per-session home
Launches headless with `cursor-agent --workspace <worktree> --print`
Runs with the yolo / trust flag — Watchfire sandbox is the boundary

See the full Cursor Agent backend page

Setup

Install Watchfire and initialise a project that defaults to Cursor Agent. Make sure the agent CLI itself is installed and signed in first.

watchfire init --agent cursor

Related docs

Other agents integrations

First-class

Ready to go

Get started with Watchfire

Install in seconds. Define tasks. Let agents ship code for you.

Download for macOS

Available for macOS, Linux, and Windows

install

# Install via Homebrew (macOS)

$brew tap watchfire-io/tap

$brew install --cask watchfire-io/tap/watchfire

# Set up your project and go

$watchfire init

$watchfire task add "Build the login page"

$watchfire start --all

Includes GUI, CLI, and daemon. Also available via Homebrew.

View on GitHub Read the Docs