> ## 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.

# Kilo

> Use Costa inside the Kilo Cursor agent with secure defaults

## Quick Setup

### Step 1: Install Cursor

Download and install Cursor from [cursor.com/download](https://cursor.com/download).

### Step 2: Install Kilo

<p>
  <a
    href="cursor:extension/kilocode.Kilo-Code"
    style={{ 
display: 'inline-block',
padding: '8px 16px',
marginLeft: '5px',
background: '#4f46e5',
color: 'white',
borderRadius: '6px',
textDecoration: 'none'
}}
  >
    Install Kilo in Cursor
  </a>
</p>

### Step 3: Install Costa

<Tabs>
  <Tab title="CLI">
    ```bash theme={null}
    costa setup kilo-code
    ```

    How to install the CLI? [ click here](/costa-code/cli)
  </Tab>

  <Tab title="Manual">
    ### 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](https://ai.costa.app) → **Settings** → **API Keys**.
    3. Adjust any defaults you need (for example, `openAiModelId`) before importing.

    ```json kilo.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 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).
  </Tab>
</Tabs>

## 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 [support@costa.app](mailto:support@costa.app).