Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Emanuele-web04/synara/llms.txt

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

Kilo Code is an AI coding assistant whose CLI and server API are protocol-compatible with OpenCode. Synara integrates with Kilo through the same OpenCode-compatible adapter layer, meaning it can launch a local kilo process and manage its lifecycle automatically, or connect to a remote Kilo server you already operate.
Because Kilo shares the OpenCode wire protocol, Synara’s Kilo adapter reuses the OpenCode runtime with Kilo-specific process settings — including the kilo serve startup command, the KILO_CONFIG_CONTENT environment variable, and the kilo server listening ready prefix. See Concepts: Providers for more on how Synara manages provider processes.

​
Prerequisites

You need one of the following before enabling this provider:
  • Local binary mode — the kilo CLI must be installed and on your PATH, or you must supply a full path to it via binaryPath.
  • Remote server mode — a reachable Kilo server URL and, if the server requires authentication, its password.

​
Configuration

Provider settings live in the providers.kilo block of your Synara settings.json. See Configuration: Settings for the full settings file reference.
​
enabled
boolean
default:"true"
Enables or disables the Kilo provider. When false, Synara will not attempt to start or connect to a Kilo server.
​
binaryPath
string
default:"kilo"
Path to the kilo executable. Accepts a bare binary name resolved from PATH or an absolute path. Only consulted in local binary mode.
​
serverUrl
string
default:""
URL of a remote Kilo server (e.g. http://kilo.internal:5000). When set, Synara skips spawning a local process and connects to this server instead. Leave empty to use local binary mode.
​
serverPassword
string
default:""
Password for HTTP Basic authentication against the remote Kilo server. Only used when serverUrl is set. Leave empty if the server does not require authentication.
​
customModels
string[]
Additional model slugs to surface in the model picker alongside the built-in list. Kilo model slugs follow the <providerID>/<modelID> convention (e.g. "anthropic/claude-opus-4-6").

​
Built-in models

Synara ships with one pre-configured Kilo model slug:
SlugName
kilo/kilo-auto/freeKilo Auto Free
Additional models available on your Kilo account can be added via customModels.

​
Local binary vs remote server

The mode is selected automatically based on whether serverUrl is non-empty. Local binary mode (default): Synara starts kilo serve on an available local port, waits for the process to report it is listening, and pools the server across concurrent threads. An idle server is shut down after 5 minutes of inactivity. Remote server mode: Synara connects directly to the serverUrl you specify. The local binary is never invoked. This is the recommended approach when running Kilo inside a container, on a remote machine, or as a shared team service.
When using serverPassword, set serverUrl to an HTTPS endpoint to prevent the credential from being sent in plain text.

​
Example settings.json

{
  "providers": {
    "kilo": {
      "enabled": true,
      "binaryPath": "kilo"
    }
  }
}

​
Related

Build docs developers (and LLMs) love

Get started for freeTalk to us