Skip to main content

​
Quick Setup

​
Step 1: Install VS Code

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

​
Step 2: Install Kilo

Install Kilo in VS Code

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

​
Step 3: Prepare Your Costa Profile

  1. Copy the block below into a local kilo.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.
kilo.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 Kilo

  1. In the Kilo sidebar, open Settings → About → Import Settings.
  2. Select the kilo.settings.json file you just saved and confirm the import.
  3. Prefer manual editing instead of importing? Run Kilo: Open Settings from the command palette (Ctrl+Shift+P) and append the provider profile block (objects keyed by ID).

​
Usage

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

​
Support

Questions or issues? Reach us anytime at [email protected].