Skip to main content

Quick Setup

Step 1: Install Jetbrains

Download and install Cursor from 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.

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.appSettingsAPI Keys.
  3. Adjust any defaults you need (for example, openAiModelId) before importing.
roo.settings.json
{
  "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.

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 [email protected] and we’ll get you unblocked.