> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trydraft.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor Agent

> Using Cursor's Agent CLI for headless execution

## Setup

Install Cursor from [cursor.com](https://www.cursor.com/) and ensure the CLI is in your PATH.

## Configuration

### Headless Mode (Cursor Agent)

```yaml theme={null}
executor_config:
  executor_type: CURSOR_AGENT
```

Cursor Agent runs headlessly — no IDE window opens. The agent implements the ticket and exits.

### Interactive Mode (Cursor IDE)

```yaml theme={null}
executor_config:
  executor_type: CURSOR
```

Interactive mode opens the Cursor IDE for each ticket. The ticket immediately moves to `NEEDS_HUMAN` since a human is expected to work alongside the agent.

## Behavior Differences

| Feature           | CURSOR\_AGENT | CURSOR          |
| ----------------- | ------------- | --------------- |
| Headless          | Yes           | No              |
| Auto-verify       | Yes           | No              |
| Human interaction | None          | Required        |
| Post-execution    | → `VERIFYING` | → `NEEDS_HUMAN` |

## Log Normalization

Draft normalizes Cursor's log output into a structured format for easier reading in the UI. The `CursorLogNormalizer` service handles parsing Cursor's streaming output.