Skip to content

docs: add 'Using Kilo for Free' documentation page#5742

Open
kiloconnect[bot] wants to merge 3 commits intomainfrom
session/agent_6c2a5c68-fbc9-467d-bf4a-e1e235754dae
Open

docs: add 'Using Kilo for Free' documentation page#5742
kiloconnect[bot] wants to merge 3 commits intomainfrom
session/agent_6c2a5c68-fbc9-467d-bf4a-e1e235754dae

Conversation

@kiloconnect
Copy link
Contributor

@kiloconnect kiloconnect bot commented Feb 7, 2026

Summary

Add a new documentation page called "Using Kilo for Free" to help users understand how to use Kilo Code without spending money.

Changes

Documentation Page

  • Updated apps/kilocode-docs/pages/getting-started/using-kilo-for-free.md

Navigation Update

  • Added the new page to the Getting Started navigation in apps/kilocode-docs/lib/nav/getting-started.ts

Content Covered

1. Free Models for Agentic Tasks

  • Explains that free models are available and labeled as "free" in the model picker
  • Instructions on how to find and select free models in both VS Code extension and CLI
  • Evergreen content that doesn't reference specific model names

2. Free Autocomplete

  • Explains how autocomplete works (routed through Kilo Code by default, uses credits)
  • Documents that configuring Mistral directly takes precedence and provides free completions
  • Links to the detailed Mistral Setup Guide instead of reproducing steps

3. CLI Background Tasks

  • Explains what background tasks do (session title generation, context summarization)
  • Documents graceful degradation behavior when credits aren't available
  • Documents the small_model parameter in ~/.kilocode/config.json
  • Explains that gpt-5-nano is the default (not free) and how to configure a free model

Testing

  • Documentation-only change, no code changes to test

Built for Alex Gold by Kilo for Slack

Add a new documentation page covering:
- Free models available through Kilo Gateway and OpenRouter
- Free autocomplete setup with Mistral Codestral
- CLI background tasks (session titles, context summarization)
- Graceful degradation when credits aren't available
@changeset-bot
Copy link

changeset-bot bot commented Feb 7, 2026

⚠️ No Changeset found

Latest commit: 20aff16

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

- Add opening context about free models for agentic tasks
- Make content evergreen by not referencing specific free models
- Remove OpenRouter free tier section
- Link to mistral-setup page instead of reproducing steps
- Replace 'Supported Autocomplete providers' with 'How it works' section
- Add CLI background tasks configuration info (small_model parameter)
- Keep CLI background tasks section as-is

### Configuring Background Tasks

You can configure which model the CLI uses for background tasks by setting the `small_model` parameter in `~/.kilocode/config.json`. By default, this is set to `gpt-5-nano`, which is not free.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: CLI config path may be incorrect

This page references ~/.kilocode/config.json, but the CLI config file path in cli/src/config/persistence.ts is ~/.kilocode/cli/config.json (see CONFIG_DIR/CONFIG_FILE). If the docs intend to describe the CLI config file, the path should match the implementation.

Suggested change
You can configure which model the CLI uses for background tasks by setting the `small_model` parameter in `~/.kilocode/config.json`. By default, this is set to `gpt-5-nano`, which is not free.
You can configure which model the CLI uses for background tasks by setting the `small_model` parameter in `~/.kilocode/cli/config.json`. By default, this is set to `gpt-5-nano`, which is not free.

@kiloconnect
Copy link
Contributor Author

kiloconnect bot commented Feb 7, 2026

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (2 files)

@alexkgold alexkgold requested a review from olearycrew February 7, 2026 16:26
@alexkgold alexkgold enabled auto-merge February 7, 2026 16:27
@kevinvandijk kevinvandijk added the documentation Improvements or additions to documentation label Feb 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants