Skip to content

docs: document auto-detect models for custom providers and settings export/import #7824

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ScuttleBot wants to merge 2 commits into
base: main
Choose a base branch
from
+19 −2
Open

docs: document auto-detect models for custom providers and settings export/import #7824

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3fb3dc5
docs: add auto-detect models for custom providers, update settings ex…
Mar 27, 2026
76eaed5
Update packages/kilo-docs/pages/getting-started/settings/index.md
olearycrew Mar 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion packages/kilo-docs/pages/ai-providers/openai-compatible.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ You'll find these settings in the Kilo Code settings panel (click the {% codicon
- **API Provider:** Select "OpenAI Compatible".
- **Base URL:** Enter the base URL provided by your chosen provider. **This is crucial.**
- **API Key:** Enter your API key.
- **Model:** Choose a model.
- **Model:** Choose a model (see [Automatic Model Detection](#automatic-model-detection) below).
- **Model Configuration:** This lets you customize advanced configuration for the model
- Max Output Tokens
- Context Window
Expand All @@ -34,6 +34,18 @@ You'll find these settings in the Kilo Code settings panel (click the {% codicon
- Input Price
- Output Price

### Automatic Model Detection

When configuring a custom OpenAI-compatible provider in the VS Code extension, Kilo Code can automatically detect available models from your provider's `/v1/models` endpoint.

Once you enter a valid **Base URL** and **API Key**, Kilo Code will query the provider and present a searchable model picker with all available models. You can:

- **Search** with fuzzy matching (e.g., typing "gpt4o" finds "gpt-4o-mini")
- **Select** individual models to add to the provider configuration
- **Edit** an existing custom provider to add or remove models later

This eliminates the need to manually look up and type model IDs. If auto-detection fails (for example, if the provider doesn't support the `/v1/models` endpoint), you can still enter model IDs manually.

### Full Endpoint URL Support

Kilo Code supports full endpoint URLs in the Base URL field, providing greater flexibility for provider configuration:
Expand Down
7 changes: 6 additions & 1 deletion packages/kilo-docs/pages/getting-started/settings/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,12 @@ If you check config files into version control, make sure they do not contain AP

### Export and Import

Config files are plain-text and portable — copy them between machines and you're done.
You can export and import settings from the **About Kilo Code** tab in the Settings UI:

- **Export**: Saves your global config as a `kilo-settings.json` file. Review it before sharing, because config values are exported as-is.
- **Import**: Loads a previously exported JSON file into the settings draft. Changes are not applied immediately — you can review them and click Save or Discard, just like any manual edit.

Config files are also plain-text and portable — you can copy `~/.config/kilo/kilo.jsonc` between machines directly.

{% /tab %}
{% tab label="CLI" %}
Expand Down
Loading