docs: fix CLI config file path to use XDG convention#5735

Open

kiloconnect[bot] wants to merge 1 commit intomainfrom

fix/cli-docs-config-path

Contributor

kiloconnect bot commented Feb 6, 2026 •

edited

Loading

Summary

Update CLI config file path from ~/.kilocode/config.json to ~/.config/kilo/config.json
Replace outdated auto-approval section with the permissions system (adapted from OpenCode docs for Kilo)

Changes

apps/kilocode-docs/pages/code-with-ai/platforms/cli.md:

Fixed config path references to ~/.config/kilo/config.json
Replaced the "Auto-approval Settings" section with a comprehensive "Permissions" section covering:
- Actions (allow/ask/deny)
- Global and per-tool configuration
- Granular rules with object syntax
- Wildcard pattern matching
- Home directory expansion
- External directory access
- Available permissions list
- Default permission values
- Agent-specific permission overrides

MCP settings path left unchanged (not part of this fix).

Built for josh by Kilo for Slack

Contributor Author

kiloconnect bot commented Feb 6, 2026 •

edited

Loading

Code Review Summary

Status: 4 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	4
SUGGESTION	0

Fix these issues in Kilo Cloud

Issue Details (click to expand)

WARNING

File	Line	Issue
`apps/kilocode-docs/pages/code-with-ai/platforms/cli.md`	168	Docs config path doesn’t match CLI’s current config location
`apps/kilocode-docs/pages/code-with-ai/platforms/cli.md`	N/A	Auto-approval section references a config path the CLI may not use
`apps/kilocode-docs/pages/code-with-ai/platforms/cli.md`	190	`permission` examples don’t match current CLI config schema (`autoApproval`)
`apps/kilocode-docs/pages/code-with-ai/platforms/cli.md`	224	Example path in permissions snippet doesn’t exist in this repo

Files Reviewed (1 files)

apps/kilocode-docs/pages/code-with-ai/platforms/cli.md - 4 issues

changeset-bot bot commented Feb 6, 2026 •

edited

Loading

⚠️ No Changeset found

Latest commit: 6c08236

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

kiloconnect bot force-pushed the fix/cli-docs-config-path branch from fa3a8bf to 9462d59 Compare

February 7, 2026 02:56

kiloconnect bot commented

View reviewed changes

apps/kilocode-docs/pages/code-with-ai/platforms/cli.md

               - `/connect` command for provider setup (interactive)
-              - Config files directly at `~/.kilocode/config.json`
+              - Config files directly at `~/.config/kilo/config.json`

Contributor Author

kiloconnect bot Feb 7, 2026

WARNING: Config path in docs doesn’t match current CLI config location

The CLI currently uses cli/src/config/persistence.ts:18 (~/.kilocode/cli/config.json by default). Pointing users at ~/.config/kilo/config.json will likely cause confusion unless the CLI has been updated to use XDG paths as well.

Suggested change

      
            - Config files directly at `~/.config/kilo/config.json`
          
            - Config files directly at `~/.kilocode/cli/config.json`

apps/kilocode-docs/pages/code-with-ai/platforms/cli.md Outdated

               ## Auto-approval Settings
-              Auto-approval allows the Kilo Code CLI to perform operations without first requiring user confirmation. These settings can either be built up over time in interactive mode, or by editing your config file directly at `~/.kilocode/config.json`.
+              Auto-approval allows the Kilo Code CLI to perform operations without first requiring user confirmation. These settings can either be built up over time in interactive mode, or by editing your config file directly at `~/.config/kilo/config.json`.

Contributor Author

kiloconnect bot Feb 7, 2026

WARNING: Auto-approval section references a config path the CLI may not use

Same mismatch as above: the default config file path is derived from cli/src/config/persistence.ts:18. If the docs intend to describe an XDG path, it would be good to either document both paths (legacy vs XDG) or align the CLI implementation.

Suggested change

      
            Auto-approval allows the Kilo Code CLI to perform operations without first requiring user confirmation. These settings can either be built up over time in interactive mode, or by editing your config file directly at `~/.config/kilo/config.json`.
          
            Auto-approval allows the Kilo Code CLI to perform operations without first requiring user confirmation. These settings can either be built up over time in interactive mode, or by editing your config file directly at `~/.kilocode/cli/config.json`.


          docs: fix CLI config path and replace auto-approval with permissions

6c08236

- Update CLI config file path from ~/.kilocode/config.json to ~/.config/kilo/config.json
- Replace outdated auto-approval section with permissions system from OpenCode docs
- Revert MCP settings path changes (kept as-is)

kiloconnect bot force-pushed the fix/cli-docs-config-path branch from 9462d59 to 6c08236 Compare

February 7, 2026 03:01

lambertjosh requested a review from marius-kilocode

February 7, 2026 03:04

kiloconnect bot commented

View reviewed changes

apps/kilocode-docs/pages/code-with-ai/platforms/cli.md

-              			"enabled": false,
-              			"timeout": 60
+              	"$schema": "https://kilo.ai/config.json",
+              	"permission": {

Contributor Author

kiloconnect bot Feb 7, 2026

WARNING: permission config examples don’t match the CLI config schema

This doc section shows a top-level permission key, but the CLI config schema currently defines autoApproval (and does not appear to accept permission). As written, users may add permission to their config and see no effect.

References: packages/core-schemas/src/config/cli-config.ts (expects autoApproval), and CLI config persistence defaults to a config.json that is merged/validated against that schema in cli/src/config/persistence.ts.

apps/kilocode-docs/pages/code-with-ai/platforms/cli.md

-              			"delay": 10
+              		"edit": {
+              			"*": "deny",
+              			"packages/web/src/content/docs/*.mdx": "allow"

Contributor Author

kiloconnect bot Feb 7, 2026

WARNING: Example path in permissions snippet doesn’t exist in this repo

packages/web/src/content/docs/*.mdx doesn’t appear to be a path in this repository, so readers copying this example will likely end up with a rule that never matches. Consider using a path that exists under apps/kilocode-docs/ (or replace with a clearly-marked placeholder).

Suggested change

      
            			"packages/web/src/content/docs/*.mdx": "allow"
          
            			"apps/kilocode-docs/pages/**/*.md": "allow"

kevinvandijk requested a review from olearycrew

February 8, 2026 01:56

kevinvandijk assigned olearycrew

kevinvandijk added the documentation label

marius-kilocode approved these changes

View reviewed changes

marius-kilocode reviewed

View reviewed changes

apps/kilocode-docs/pages/code-with-ai/platforms/cli.md

+              ```json
+              {
+              	"$schema": "https://kilo.ai/config.json",

Collaborator

marius-kilocode Feb 9, 2026

The schema doesn't exist yet. I see two options:

We continue with this and commit to providing this the future
We link to the upstream schema opencode.ai/config.json

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels