Skip to main content

​
Quick Setup

​
Step 1: Install VS Code

Download and install VS Code from code.visualstudio.com.

​
Step 2: Install Roo Code

Install Roo in VS Code

Use this curl command to fetch your Costa configuration directly: 
curl -fsSL https://raw.githubusercontent.com/costa-security/install/main/roo/vscode_init.sh | bash -s -- <YOUR_API_KEY>

​
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 → Settings → API 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.

​
Usage

  • Open the Roo 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.