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

# Cursor CLI

> AI-first code editor built on VS Code with parallel agent support

## Overview

Cursor CLI is an AI-first code editor built on VS Code, trusted by Fortune 500 companies for its advanced capabilities. It features the proprietary Cursor 2.0 model alongside support for GPT-5, Claude 4.5 models, Gemini 3 Pro, and Grok Code. The Composer feature enables instant code generations with parallel agent support for complex tasks.

## Latest Models

Cursor CLI provides access to cutting-edge models:

* **Cursor 2.0** - Proprietary model optimized for code editing
* **GPT-5** - OpenAI's latest flagship model
* **Claude 4.5 Sonnet** - Anthropic's high-performance model
* **Claude 4.5 Opus** - Anthropic's most capable model
* **Gemini 3 Pro** - Google's advanced reasoning model
* **Grok Code** - Specialized code generation model

<Note>
  Cursor's Composer feature allows multiple agents to work in parallel, significantly speeding up complex multi-file changes.
</Note>

## Authentication

Cursor CLI requires a Cursor API key:

<Tabs>
  <Tab title="Cursor API Key">
    **Get your Cursor API key**

    1. Sign up at [Cursor](https://cursor.com/)
    2. Subscribe to Cursor Pro or Team plan
    3. Generate an API key in Cursor settings
    4. Set the environment variable: `CURSOR_API_KEY=cursor-...`
    5. In [Blocks Dashboard](https://blocks.team), go to **Dashboard** → **Agents**
    6. Select **Cursor CLI** and paste your API key
  </Tab>
</Tabs>

<Tip>
  Cursor API keys are available with Cursor Pro (\$20/month) or Team plans. The API includes access to all supported models.
</Tip>

## Using Cursor CLI

Use the `/cursor` slash command to invoke Cursor CLI:

```
@blocks /cursor refactor this component with parallel agents
@blocks /cursor implement this feature using Cursor 2.0
```

<Note>
  Cursor CLI must be explicitly invoked with the `/cursor` command and cannot be set as your default agent.
</Note>

## Best For

* VS Code integration (familiar interface)
* Parallel agent workflows (multiple agents working together)
* Instant code generations with Composer
* Fortune 500-grade reliability
* Complex multi-file refactoring
* Teams already using VS Code
* Access to multiple premium models in one subscription

## Cost

Cursor CLI uses your Cursor subscription:

* Cursor Pro: \$20/month (includes API access)
* Cursor Team: Custom pricing for organizations
* Check [Cursor Pricing](https://cursor.com/pricing) for details
* All models included in subscription (no per-token billing)
* Monitor usage in Cursor dashboard

<Note>
  Unlike pay-as-you-go API services, Cursor uses a subscription model with unlimited usage, making costs predictable.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Claude Code" icon="brain" href="/using-blocks/agents/claude-code">
    Learn about Claude Code
  </Card>

  <Card title="OpenCode Agent" icon="globe" href="/using-blocks/agents/opencode">
    Explore OpenCode's multi-provider support
  </Card>
</CardGroup>