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

# Roo Code

> Connect Costa to Roo Code for secure AI assistance

## Quick Setup

### Step 1: Install Jetbrains

Download and install Cursor from [jetbrains.com/idea/download/](https://www.jetbrains.com/idea/download).

### Step 2: Install Roo Code

1. Open Jetbrains.
2. Go to **Extensions** (`Ctrl+Shift+X`).
3. Search for **"Roo"** (or **"Roo Code"**) and install the official extension from Roo.dev.
4. Sign in with your Roo account so settings can sync across devices.

<Accordion title="Manual Setup">
  ### Step 3: Prepare Your Costa Profile

  1. Copy the block below into a local `roo.settings.json` file.
  2. Replace `REPLACE_WITH_YOUR_API_KEY` with the token from [ai.costa.app](https://ai.costa.app) → **Settings** → **API Keys**.
  3. Adjust any defaults you need (for example, `openAiModelId`) before importing.

  ```json roo.settings.json theme={null}
  {
    "providerProfiles": {
      "currentApiConfigName": "default",
      "apiConfigs": {
        "default": {
          "reasoningEffort": "medium",
          "openAiBaseUrl": "https://ai.costa.app/api/v1",
          "openAiApiKey": "REPLACE_WITH_YOUR_API_KEY",
          "openAiModelId": "costa/orbit",
          "openAiCustomModelInfo": {
            "maxTokens": -1,
            "contextWindow": 128000,
            "supportsImages": true,
            "supportsPromptCache": false,
            "inputPrice": 0,
            "outputPrice": 0
          },
          "openAiStreamingEnabled": true,
          "openAiHeaders": {},
          "apiProvider": "openai",
          "id": "opj193bok48"
        }
      },
      "modeApiConfigs": {
        "architect": "opj193bok48",
        "code": "opj193bok48",
        "ask": "opj193bok48",
        "debug": "opj193bok48",
        "orchestrator": "opj193bok48"
      },
      "migrations": {
        "rateLimitSecondsMigrated": true,
        "diffSettingsMigrated": true,
        "openAiHeadersMigrated": true,
        "consecutiveMistakeLimitMigrated": true,
        "todoListEnabledMigrated": true
      }
    }
  }
  ```

  ### Step 4: Import the Profile into Roo

  1. Open **Settings → Providers** inside Roo Code and choose **Import Configuration**.
  2. Select the `roo.settings.json` file you just saved (or paste its contents) and confirm the import.
  3. Prefer editing inline? Stay in **Settings → Providers** and paste the JSON block into the provider editor directly.
</Accordion>

## Usage

* Open the Kilo chat panel in VS Code sidebar
* Select any Costa model from the dropdown
* Start coding with AI assistance

## Support

Need help? Email [support@costa.app](mailto:support@costa.app) and we’ll get you unblocked.