Skip to content

docs: add Cost Controls and Usage Safeguards page - #11715

Merged
jobrietbergen merged 4 commits into
mainfrom
docs/cost-controls-and-usage-safeguards
Jun 26, 2026
Merged

docs: add Cost Controls and Usage Safeguards page#11715
jobrietbergen merged 4 commits into
mainfrom
docs/cost-controls-and-usage-safeguards

Conversation

@kilo-code-bot

@kilo-code-bot kilo-code-bot Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds a new documentation page at getting-started/cost-controls-and-usage-safeguards covering all currently available controls for preventing runaway usage, reducing token consumption, choosing models by task type, and governing spend at the org level.
  • Updates the Getting Started nav to include the new page under the Configuration section, adjacent to the existing Cost Efficiency & Model Selection page.
  • Adds a Maximum-constraint starter configuration section with a copy-paste kilo.jsonc snippet covering every available cost-control field set to its most restrictive value, using only kilo-auto/efficient and kilo-auto/free tiers.

What's in the page

The page complements the existing Cost Efficiency & Model Selection page by going deeper on safeguard configuration rather than repeating the Auto Model tier overview or per-request cost math.

Sections:

  • Overview — the six factors that drive cost; why no single control is sufficient alone
  • Preventing Loops and Runaway Usage — doom loop permission, per-tool approval controls, runtime shield toggle, spending limits, rate limits, and practical prompt hygiene recommendations
  • Reducing Context and Token Usage — session management, @file targeting, permission deny rules for build/generated dirs, compaction config, max output tokens, project instructions, MCP server management, and prompt caching
  • Choosing Models for Specific Tasks — task-type mapping, manual model selection, per-agent model config in kilo.jsonc, org-level restrictions
  • How Kilo Auto Models Work — neutral description of the four tiers and their routing strategies; explicit callout that Auto ≠ cheapest
  • Enterprise Cost Controls — model access controls (blocklist), per-user daily limits, shared credit pool, auto top-up, analytics dashboard, audit logs, admin permissions
  • Recommended Configurations — four practical scenarios: cost-conscious individual, large repo, multi-model team, enterprise admin
  • Maximum-constraint starter configuration — a complete, copy-paste kilo.jsonc covering model, small_model, subagent_model, per-agent model and steps, all compaction sub-fields (auto, threshold_percent, prune, tail_turns, preserve_recent_tokens, reserved), tool_output truncation thresholds, all relevant permission entries (bash, edit, task, webfetch, websearch, doom_loop), and share — every field verified against the live config schema and set to its most restrictive option
  • Troubleshooting Unexpected Usage — checklist + links to usage dashboard and further reading

All content is based on features verified in the existing docs and codebase. No planned or speculative features are described.

Built for Lígia Zanchet by Kilo for Slack

@vercel

vercel Bot commented Jun 26, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs (docs-staging) Ready Ready Preview, Comment Jun 26, 2026 7:46am

Request Review

@kilo-code-bot

kilo-code-bot Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor Author

Code Review Summary

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
packages/kilo-docs/pages/getting-started/cost-controls-and-usage-safeguards.md 290 The callout says the starter config uses only kilo-auto/efficient, but the snippet still includes multiple kilo-auto/free agent entries.

Fix these issues in Kilo Cloud

Files Reviewed (1 file)
  • packages/kilo-docs/pages/getting-started/cost-controls-and-usage-safeguards.md - 1 issue
Previous Review Summaries (3 snapshots, latest commit 5761f8b)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 5761f8b)

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)
  • packages/kilo-docs/pages/getting-started/cost-controls-and-usage-safeguards.md

Previous review (commit a2af9a9)

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
packages/kilo-docs/pages/getting-started/cost-controls-and-usage-safeguards.md 59 Free-model rate limit no longer matches the repo's IP-based wording for anonymous access.

Fix these issues in Kilo Cloud

Files Reviewed (1 file)
  • packages/kilo-docs/pages/getting-started/cost-controls-and-usage-safeguards.md - 1 issue

Previous review (commit 10fcd8b)

Status: No Issues Found | Recommendation: Merge

Files Reviewed (2 files)
  • packages/kilo-docs/lib/nav/getting-started.ts
  • packages/kilo-docs/pages/getting-started/cost-controls-and-usage-safeguards.md

Reviewed by gpt-5.4-20260305 · Input: 58.1K · Output: 6.7K · Cached: 244.5K

Review guidance: REVIEW.md from base branch main

Updated rate limit information for free models and clarified configuration locations. Removed outdated sections on Auto Models and Enterprise features.
Removed references to 'kilo-auto/free' model in configuration and updated comments accordingly.
The snippet below is a ready-to-copy `kilo.jsonc` that turns on every available cost-control knob at its most restrictive setting. Drop it into your project root (or your global `~/.config/kilo/kilo.jsonc`) and adjust individual values upward as you get comfortable with how each one behaves.

{% callout type="tip" %}
This configuration uses only `kilo-auto/efficient`.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

WARNING: The example no longer matches its own model-usage description

This callout now says the starter config uses only kilo-auto/efficient, but the snippet still sets agent.explore, agent.compaction, agent.title, and agent.summary to kilo-auto/free. That leaves the copy-paste example self-contradictory unless either the callout text or those remaining agent entries are updated.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

@jobrietbergen
jobrietbergen merged commit e0c1e72 into main Jun 26, 2026
27 checks passed
@jobrietbergen
jobrietbergen deleted the docs/cost-controls-and-usage-safeguards branch June 26, 2026 09:33
t7tran pushed a commit to t7tran/kilocode that referenced this pull request Aug 14, 2026
…d-usage-safeguards

docs: add Cost Controls and Usage Safeguards page
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants