Agentsflare Kilo CLI Configuration Guide

Kilo CLI is a terminal coding agent by Kilo Code. It is a fork of OpenCode and supports the same configuration options, with access to hundreds of LLMs.

Installing and Configuring Kilo CLI

Installing Kilo CLI

Install via npm:

npm install -g @kilocode/cli

Verify installation:

kilo --version

Upgrade:

kilo upgrade

Older CPUs (No AVX Support)

On older CPUs without AVX support the CLI may crash with "Illegal instruction". Download the -baseline variant for your platform from Kilo Releases instead.

Configuring Kilo CLI

Kilo CLI reads its global configuration from ~/.config/kilo/kilo.json (project-level ./kilo.json takes precedence). Edit the global config file and add the following:

{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "agentsflare": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "agentsflare",
      "options": {
        "baseURL": "https://api.agentsflare.com/v1",
        "apiKey": "{env:AGENTSFLARE_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "limit": {
            "context": 200000,
            "output": 64000
          },
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "claude-opus-5": {
          "name": "Claude Opus 5",
          "limit": {
            "context": 200000,
            "output": 32000
          },
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        },
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5",
          "limit": {
            "context": 200000,
            "output": 64000
          },
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        }
      }
    }
  },
  "model": "agentsflare/claude-sonnet-5"
}

Then set the API key environment variable in your shell profile (~/.bashrc, ~/.zshrc, etc.):

export AGENTSFLARE_API_KEY="Your Agentsflare API key"

Restart your terminal for the configuration to take effect, then run kilo to start the TUI and select an agentsflare model.

To add more models, register them under provider.agentsflare.models in the config file. Available models are listed in Supported Models — use the model ID as the key.

Interactive Configuration

You can also add provider credentials interactively:

1. Run kilo and use the /connect command to add provider credentials.
2. Or manage AI providers and credentials with the kilo auth command.
3. Use kilo models agentsflare to list all models available under the configured provider.

Common Issues

{env:AGENTSFLARE_API_KEY} is ignored with a warning

{env:VAR} references are only resolved in trusted config: the global config (~/.config/kilo/) or config passed via KILO_CONFIG / KILO_CONFIG_CONTENT. A project-level kilo.json committed to a repository cannot use {env:VAR} — put the API key reference in the global config, or write the key directly in the project config.

How to switch models

The default model uses the provider_id/model_id format (e.g. "model": "agentsflare/claude-opus-5"). Inside the TUI you can also switch models directly.

Migrated from OpenCode?

Kilo CLI 1.0 no longer reads configuration from ~/.config/opencode or ./.opencode/. Move your global config into ~/.config/kilo/ and project config into ./.kilo/ (or ./kilo.json).

Related Documentation

• API Address Information
• Supported Models
• Opencode Configuration