Skip to main content

​
Quick Setup

​
Step 1: Install Roo Code

  • Download Roo Code from Roo.dev or your preferred marketplace.
  • Launch Roo and sign in with your Roo account so you can sync settings across devices.

​
Step 2: Point Roo to Costa

  1. Open Settings → Providers inside Roo Code and choose Import Configuration.
  2. Paste the JSON block below or load it from file; Roo will populate every default Costa profile for you.
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
    }
  }
}
Replace the API key with the token from ai.costa.app → Settings → API Keys. Switch openAiModelId to another Costa router (costa/auto, costa/nebula, etc.) whenever you want a different default.

​
Step 3: Set Workspace Defaults

For repository-level overrides, create .roo/settings.json in the project root:
.roo/settings.json
{
  "roo.defaultProvider": "costa-secure",
  "roo.model": "costa/auto",
  "roo.auditLogging": true
}

​
Usage Tips

  • Launch New Chat in Roo and choose Costa Secure Stack to keep sessions on Costa’s shielded routing.
  • Toggle Audit Mode so security leads can stream real-time logs while you pair-program.
  • Use Roo’s model switcher to compare Costa-managed Claude, Gemini, and GPT variants without reconfiguring providers.

​
Troubleshooting

  • Run just check-links before opening a PR that touches this page to validate internal references.
  • If Roo cannot reach Costa, confirm your network allows https://ai.costa.app.
  • Regenerate your Costa API key immediately if it is ever exposed; Costa revokes compromised tokens in real time.