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

# Cursor Rules

> Download .mdc rule files for Cursor IDE integration with the Runloop Python and TypeScript SDKs

## Cursor Rules for Runloop

We provide [Cursor rules](https://docs.cursor.com/context/rules) files (`.mdc`) that give your AI assistant context about the Runloop SDK — covering devbox lifecycle, file operations, command execution, blueprints, snapshots, tunnels, and more.

### Download

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/static/files/runloop-python-client.mdc">
    `.mdc` rules for `runloop_api_client` (async SDK)
  </Card>

  <Card title="TypeScript" icon="js" href="/static/files/runloop-typescript-client.mdc">
    `.mdc` rules for `@runloop/api-client`
  </Card>
</CardGroup>

### Setup

<Steps>
  <Step title="Download the .mdc file">
    Click the card above for your language to download the `.mdc` file.
  </Step>

  <Step title="Add to your project">
    Place the file in your project's `.cursor/rules` directory:

    ```bash theme={null}
    mkdir -p .cursor/rules
    # Move the downloaded file into .cursor/rules/
    ```
  </Step>

  <Step title="Start coding">
    Cursor will automatically use the rules to provide SDK-aware suggestions and completions.
  </Step>
</Steps>

<Note>
  The `.mdc` files are the maintained source of truth for Runloop cursor rules. They cover the current SDK surface including `AsyncRunloopSDK` (Python) and `RunloopSDK` (TypeScript) with auto-loaded API keys from the `RUNLOOP_API_KEY` environment variable.
</Note>