Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.auriko.ai/llms.txt

Use this file to discover all available pages before exploring further.

Auriko connects to Kilo Code as a provider, giving you access to multiple models through a single API key.

​
Prerequisites

​
Install Kilo Code

Open Extensions in VS Code (Cmd+Shift+X on macOS, Ctrl+Shift+X on Windows/Linux), search “Kilo Code”, and install.
Install via npm:
npm install -g @kilocode/cli
Or via Homebrew (macOS):
brew install Kilo-Org/tap/kilo
Confirm the installation:
kilo --version

​
Set your API key

Export your API key: 
export AURIKO_API_KEY="ak_live_..."
Your key starts with ak_live_ (production) or ak_test_ (testing). Add this line to ~/.zshrc or ~/.bashrc to persist it across terminal sessions. Reload your shell after saving: 
source ~/.zshrc   # or: source ~/.bashrc
Or open a new terminal.

​
Add provider (VS Code)

You can add Auriko as a custom OpenAI-compatible provider in VS Code:
  1. Open Kilo Code settings (gear icon in the Kilo Code panel).
  2. Go to the Providers tab.
  3. Click Custom provider.
  4. Fill in:
    • Provider ID: auriko
    • Display name: Auriko
    • Base URL: https://api.auriko.ai/v1
    • API key: your ak_live_... key
  5. Models auto-populate. Select a model.
  6. Click Submit.
If auriko/claude-sonnet-4-6 returns a “model not found” error, add the provider definition to your kilo.json:
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "auriko/claude-sonnet-4-6",
  "provider": {
    "auriko": {
      "env": ["AURIKO_API_KEY"],
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "reasoning": true,
          "tool_call": true,
          "limit": { "context": 200000, "output": 16384 }
        }
      },
      "options": {
        "baseURL": "https://api.auriko.ai/v1"
      }
    }
  }
}
This overrides the provider registry with a local definition.

​
Verify

VS Code: Start a chat in the Kilo Code panel and send a message. You should see a response from the model you selected. CLI: Run this from inside a git repository: 
kilo run "Say exactly: setup-ok" --model auriko/claude-sonnet-4-6

​
Set default model

To avoid passing --model on every run, create a kilo.json at your project root: 
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "auriko/claude-sonnet-4-6"
}
You can also place this at ~/.config/kilo/kilo.json to set a global default. A project-root config takes precedence. VS Code users set their default model in the model picker (top of the Kilo Code panel).

​
Use different models

Pass any registered model with the --model flag: 
kilo run "Summarize this repo" --model auriko/deepseek-v4-flash
kilo run "Review my code" --model auriko/gemini-2.5-pro
VS Code: switch models in the model picker. These models are available through Auriko:
ModelAuthorContext
claude-sonnet-4-6Anthropic1M
claude-opus-4-6Anthropic1M
claude-opus-4-7Anthropic1M
deepseek-v4-flashDeepSeek1M
deepseek-v4-proDeepSeek1M
gemini-2.5-flashGoogle1M
gemini-2.5-proGoogle1M
gemini-3.1-pro-previewGoogle1M
glm-5.1Z.AI200K
grok-4.3xAI1M
kimi-k2.5Moonshot262K
kimi-k2.6Moonshot262K
minimax-m2-7MiniMax205K
minimax-m2-7-highspeedMiniMax205K
qwen-3.6-plusAlibaba1M
To list all Auriko models (not just the 15 above): 
curl -s -H "Authorization: Bearer $AURIKO_API_KEY" \
  https://api.auriko.ai/v1/models | jq '.data[].id'

​
Add unregistered models

You can use models beyond the 15 in the registry by adding a provider block to kilo.json: 
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "auriko/deepseek-v3.2",
  "provider": {
    "auriko": {
      "env": ["AURIKO_API_KEY"],
      "models": {
        "deepseek-v3.2": {
          "name": "DeepSeek V3.2",
          "reasoning": true,
          "tool_call": true,
          "limit": { "context": 163840, "output": 8192 }
        }
      },
      "options": {
        "baseURL": "https://api.auriko.ai/v1"
      }
    }
  }
}
Browse model capabilities via the directory API to fill in the model definition fields. VS Code custom provider auto-fetches all models from the API, so this section applies to CLI users only.

​
Control routing

Configure routing in the Auriko dashboard. See routing options for details.

​
Uninstall

VS Code: Remove the Auriko custom provider from Settings > Providers. Uninstall the Kilo Code extension. CLI: Remove AURIKO_API_KEY from your shell profile (~/.zshrc or ~/.bashrc). If you created a kilo.json, remove the auriko-related lines or delete the file.

​
Troubleshoot

SymptomCauseFix
Error: API key is invalid.AURIKO_API_KEY not set or wrongRun echo $AURIKO_API_KEY. If empty, export it. If set, verify at https://api.auriko.ai/v1/me
No models in custom provider dialogBase URL wrong or API unreachableUse exactly https://api.auriko.ai/v1. Enter API key first — auto-detection requires both.
Model not found (404)Wrong model ID formatVS Code: bare IDs (claude-sonnet-4-6). CLI: auriko/ prefix (auriko/claude-sonnet-4-6)
auriko/ models not resolved (CLI)Provider registry hasn’t refreshedAdd a provider block to kilo.json (see “If auriko models aren’t found”)
Connection errorbaseURL wrongUse exactly https://api.auriko.ai/v1 — no trailing slash
Config not taking effectLocal overriding globalCheck ./kilo.json (project) and ~/.config/kilo/kilo.json (global)
Empty response from kilo runNot inside a git repositoryRun from a git repo, or git init first
”Performing one time database migration…” on first runKilo Code’s SQLite migration runs once on first useWait for it to complete (typically under a minute). This only happens once.