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

# Cursor

> Add a .cursorrules file so Cursor agents call the Spine API for research and deliverables.

Drop a `.cursorrules` file into your project root and Cursor will know to delegate research and deliverable-generation tasks to the Spine API.

## Install

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
curl -o .cursorrules \
  https://docs.getspine.ai/static/agent-files/.cursorrules
```

<Card title="Download .cursorrules" icon="download" href="/static/agent-files/.cursorrules">
  `.cursorrules` — drop into your project root
</Card>

## Set your API key

Add to your shell profile or Cursor's environment:

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
export SPINE_API_KEY="sk_spine_..."
```

Create a key at [platform.getspine.ai/keys](https://platform.getspine.ai/keys).

## What it does

The `.cursorrules` file teaches Cursor's agent:

1. When to use Spine — research, reports, decks, spreadsheets, competitive analyses
2. The API pattern — `POST /v1/run` → poll `GET /v1/run/{run_id}`
3. Available templates and which to pick for each output type
4. How to surface results — `final_output` + artifact download URLs

## Example

```
You: Compile a competitive analysis of the top 5 AI coding assistants

Cursor: I'll delegate this to Spine using the deep_research template.

[Calling POST /v1/run...]
[Polling... completed in 11m 18s]

Here are the results:
- Competitive analysis (full text below)
- Download: Competitive_Analysis.docx → https://...
- Credits used: 26
```

## Combining with other rules

If you already have a `.cursorrules`, append the Spine rules at the end:

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
curl -s https://docs.getspine.ai/static/agent-files/.cursorrules >> .cursorrules
```