[github-actions]

Automated docs sync — 2026-10-20

This PR keeps kilo.ai/docs in sync with features merged to Kilo-Org/cloud and Kilo-Org/kilocode. Every change below links to the merged PR it documents.

• Window: 2026-10-17T07:01:45.756Z → 2026-10-20T07:06:54.628Z
• Verification (docs build + tests): passing

Surface: other

• Assignees / requested reviewers: @lambertjosh and @intentionally-left-nil
• Derivation: Derived from the repository layout. A product surface is a package under packages/ that ships a distinct client, plugin, backend, or hosted service: cli = packages/opencode/ + packages/tui/ + packages/server/ + packages/sdk/ + packages/plugin/; vscode = packages/kilo-vscode/ + packages/kilo-web-ui/ + packages/kilo-ui/; jetbrains = packages/kilo-jetbrains/; gateway = packages/kilo-gateway/; web = packages/kilo-console/ + packages/kilo-indexing/ + packages/kilo-memory/ + packages/kilo-sandbox/. Docs route from the IA tree packages/kilo-docs/pages/ plus docs/jetbrains-vscode-settings-parity.md: each surface lists the pages sections that document it, and the per-platform pages under packages/kilo-docs/pages/code-with-ai/platforms/ map to the matching extension surface (the vscode/ directory to vscode, jetbrains.md to jetbrains). A doc path belongs to the surface with the longest matching prefix; a path that matches none of those prefixes falls to other (the explicit other prefixes are listed under other.docs). The cloud surfaces are derived the same way from the Kilo-Org/cloud layout: cloud-mobile = apps/mobile/, cloud-web = apps/web/, cloud-extension = apps/extension/, and cloud-agent = the cloud-agent packages under packages/ (packages/cloud-agent-sdk/ + packages/cloud-agent-profile/). A cloud source names its repository while a bare string still means this repository. The pages under packages/kilo-docs/pages/collaborate/ document the cloud web app (app.kilo.ai: teams dashboard, billing, SSO, adoption dashboard), so they route to cloud-web. No page under packages/kilo-docs/pages/ documents the browser side-panel extension yet, so cloud-extension lists no docs prefix.
• Map: .github/docs-sync/surfaces.json
• Surface map: cli, vscode, jetbrains, gateway, web, cloud-mobile, cloud-web, cloud-extension, cloud-agent, other
• Source prefixes: none
• Doc prefixes: packages/kilo-docs/pages/community/, packages/kilo-docs/pages/contributing/, packages/kilo-docs/LEARNINGS.md, docs/
• Paths that fall to other: packages/kilo-docs/pages/community/, packages/kilo-docs/pages/contributing/, packages/kilo-docs/LEARNINGS.md, docs/
• How the two were computed: other has no source paths to rank, so it keeps the fixed reviewers @lambertjosh and @intentionally-left-nil from surfaces.json.

Changes

Docs change	Source
updated pages/code-with-ai/platforms/mobile.md	Kilo-Org/cloud#7756
updated pages/collaborate/teams/billing.md	Kilo-Org/cloud#7612
updated pages/code-with-ai/platforms/vscode/index.md	Kilo-Org/kilocode#14925
updated pages/getting-started/settings/auto-approving-actions.md	Kilo-Org/kilocode#15235
updated pages/code-with-ai/agents/auto-model.md	Kilo-Org/kilocode#15183
updated pages/code-with-ai/platforms/jetbrains.md	Kilo-Org/kilocode#15204
updated packages/kilo-docs/pages/code-with-ai/platforms/cloud-agent.md	Kilo-Org/cloud#8138

Pending — will retry

None.

Considered, no docs change needed

PR	Reason
Kilo-Org/kilocode#15123	Community-triage automation script change, only visible to maintainers.
Kilo-Org/kilocode#15119	Agent Manager New Worktree dialog layout redesign; same base-branch workflow, only moved inline so no new user task to document.
Kilo-Org/kilocode#15138	Internal v2 migration progress-tracking tooling, not user-facing.
Kilo-Org/kilocode#15145	Internal migration progress reporting in CI/PRs.
Kilo-Org/kilocode#15072	Adds internal gateway/code RPC contract plumbing with no user-visible setting or workflow.
Kilo-Org/cloud#7709	Dependency cleanup in cloud monorepo.
Kilo-Org/kilocode#15116	Internal gateway model-catalog variant derivation change; no documented setting or workflow shift.
Kilo-Org/kilocode#13722	Bug fix restoring expected Home/End cursor behavior in TUI filter inputs, no new learning.
Kilo-Org/cloud#7603	Cloud provider-catalog metadata persistence, not public product documentation.
Kilo-Org/cloud#7614	Cloud auto-routing benchmark service robustness and internal admin config.
Kilo-Org/cloud#7613	Mobile app visual polish with no workflow change.
Kilo-Org/cloud#7715	Internal AI-gateway usage-metadata fix, no user-visible behavior.
Kilo-Org/cloud#7645	Internal admin tool accepting email in log download, not public docs.
Kilo-Org/kilocode#15150	Community-sweep labeling/workflow automation, contributor-only.
Kilo-Org/cloud#7714	Registers a transient free stealth model in the gateway catalog; no stable documented workflow.
Kilo-Org/kilocode#15148	Adds priority labels to internal community-triage tooling.
Kilo-Org/cloud#7722	Usage-ingest queue retry/concurrency infrastructure change.
Kilo-Org/cloud#7723	Internal auto-routing scheduler initialization fix.
Kilo-Org/cloud#7712	Comment cleanup in cloud-agent-next service.
Kilo-Org/cloud#7646	Internal AI-gateway Claude tool schema normalization fix.
Kilo-Org/cloud#7711	Removes unused dead-code helper in cloud monorepo.
Kilo-Org/cloud#7405	Internal consolidation of duplicated formatBytes helpers.
Kilo-Org/cloud#7751	Internal AI-gateway reasoning-field fix for BYOK providers.
Kilo-Org/cloud#7755	Adds internal logging for tool schema combinator removal.
Kilo-Org/cloud#7754	Internal gateway plumbing replacing OpenRouter reasoning objects for BYOK providers, no user-facing setting.
Kilo-Org/cloud#7753	Internal usage-ingest service opt-in mode, not user-visible.
Kilo-Org/kilocode#15159	Internal relay command enabling the mobile agent picker, not invoked by end users.
Kilo-Org/kilocode#15124	Internal session status sync for cloud briefing, no user-facing change.
Kilo-Org/kilocode#15045	Bug fix restoring already-correct worktree move behavior for non-ASCII filenames.
Kilo-Org/cloud#7763	Internal auto-routing benchmark plumbing.
Kilo-Org/kilocode#15041	Bug fix for review comments from History view, restores expected documented behavior.
Kilo-Org/cloud#7750	Build configuration for iOS entitlements, infrastructure only.
Kilo-Org/kilocode#15134	Internal CI tooling to track v2 porting of merged PRs.
Kilo-Org/cloud#7764	Internal cloud-agent wrapper file-descriptor fix.
Kilo-Org/kilocode#15131	Automatic MCP OAuth token refresh restores expected auth behavior without new user steps.
Kilo-Org/cloud#7770	Internal gateway fix stripping message names for OpenCode Go requests.
Kilo-Org/cloud#7766	Anti-abuse step-up behavior on risky signups, not a documented user workflow.
Kilo-Org/cloud#7775	Notification copy and dev-flag tweak following #7612, no new learning.
Kilo-Org/cloud#7773	Internal admin catalog filter fix for unavailable models.
Kilo-Org/kilocode#15104	Internal reasoning replay persistence plumbing.
Kilo-Org/kilocode#15179	Internal JetBrains threading fix moving ignore-file reads off the EDT.
Kilo-Org/kilocode#15180	Internal TUI worker console redirect fix with no user-facing behavior change.
Kilo-Org/cloud#7774	Internal auto-routing benchmark recovery logic.
Kilo-Org/cloud#7776	Mobile quick chat UI and keyboard polish, no workflow change.
Kilo-Org/cloud#7782	Internal gateway protocol selection fix for OpenCode Go Muse models.
Kilo-Org/cloud#7787	Internal gateway catalog exclusion of Gemini-only OpenCode Go models.
Kilo-Org/cloud#7789	Internal security-agent findings filtering and response validation with test coverage; no user-visible workflow change.
Kilo-Org/kilocode#15186	JetBrains release PR (changelog and version bump only), no new user-facing behavior to document.
Kilo-Org/cloud#7792	CI/workflow fix to stop deploying a test fixture as a worker; infrastructure only.
Kilo-Org/cloud#7795	Internal AI-gateway prompt cache key hashing fix with no user-facing setting or workflow change.
Kilo-Org/kilocode#15185	Additive internal core module for agent usage aggregation, explicitly not user-facing on its own.
Kilo-Org/cloud#7810	Cloud/mobile session UI label fix (Desktop vs Extension); a labeling/polish change with no new user workflow, and docs-worthiness is uncertain.
Kilo-Org/kilocode#13260	The merged PR already added the options.kiloOpenAICompatibleToolCallContent bullet to pages/ai-providers/openai-compatible.md, and the option still exists as opt-in in packages/opencode/src/kilocode/provider/cloud-auth.ts. Docs are already in sync, so no change is needed.
Kilo-Org/cloud#7788	The docs intentionally do not enumerate individual free models: pages/gateway/models-and-providers.md and pages/getting-started/using-kilo-for-free.md state that free model availability changes and direct users to the live model catalog. Adding a single transient free model would contradict that guidance.
Kilo-Org/cloud#7939	Internal cloud-agent container concurrency accounting; no user-facing setting or workflow change.
Kilo-Org/cloud#7940	Enforces an existing organization-creation limit in the backend transaction; internal policy plumbing.
Kilo-Org/cloud#7890	License-driven swap of one bundled local model in the mobile app catalog; mobile app is not covered by public product docs.
Kilo-Org/cloud#7820	Internal anti-abuse signal sent to bouncer; no user-visible behavior.
Kilo-Org/cloud#7784	Contracts and DB schema scaffolding for custom auto routers with explicitly no worker or web behavior.
Kilo-Org/cloud#7793	Internal benchmark-worker tables and client evals; contributor-only tooling.
Kilo-Org/cloud#7941	Adds error-guidance UX for ChatGPT Business usage limits; error-handling polish rather than a new documented workflow.
Kilo-Org/cloud#7791	Serving-side slice of the flag-gated custom auto-router feature; not yet user-visible.
Kilo-Org/cloud#7790	Web editor/API for custom routers is gated behind the kilo-auto-custom-routers PostHog flag, so not yet user-visible.
Kilo-Org/cloud#7809	Gateway slice of the same flag-gated custom auto-router feature; no shipped user-visible behavior yet.
Kilo-Org/cloud#7945	Admin-only gateway routing config change (percentages to a switch); not part of public product docs.
Kilo-Org/kilocode#15232	Internal v2 migration host scaffolding and feature-placement tooling; not shipped user behavior.
Kilo-Org/kilocode#15231	Contributor-facing upstream progress-map tooling.
Kilo-Org/cloud#8018	Gateway bug fix adding reasoning placeholders for Reflection models; restores working behavior without a user action.
Kilo-Org/cloud#7819	Corrects BYOK labeling in model pickers; a fix to existing, already-documented model behavior.
Kilo-Org/cloud#8016	Internal Vercel session-ID/affinity plumbing with no user-facing setting.
Kilo-Org/cloud#8045	Internal gastown service ownership/authorization hardening; no user-facing workflow change.
Kilo-Org/cloud#7961	Overlap/migration step of the flag-gated custom auto-router feature plus internal notification scripts on the cloud backend.
Kilo-Org/cloud#7974	Janitor dead-code removal; no behavior change.
Kilo-Org/cloud#7968	Janitor dedupe of OAuth callback helpers; internal refactor.
Kilo-Org/kilocode#15238	Lands Kilo agents through the v2 host; internal migration work not yet visible in the shipped product.
Kilo-Org/kilocode#14999	Adds Kilo agents to v2 core; superseded by #15238 and part of the unshipped v2 migration.
Kilo-Org/cloud#8054	Adds gateway warning logging for Reflection reasoning placeholders; observability only.
Kilo-Org/cloud#8060	Admin API request-log filters and errors-only opt-ins; admin-only tooling outside public product docs.
Kilo-Org/cloud#7602	Mobile-only morning briefing feature; the public product docs do not cover the mobile app.
Kilo-Org/cloud#7785	Internal gateway refactor removing model status in favor of the unavailable list; no user-visible workflow change.
Kilo-Org/kilocode#15237	Internal v2 port of Gateway behavior and migration progress tracking only.
Kilo-Org/cloud#7946	Internal cloud-agent heartbeat/sandbox-lifetime plumbing change.
Kilo-Org/cloud#7914	Internal sandbox repository-capture keying fix.
Kilo-Org/cloud#8073	Internal ai-gateway performance change switching reads to the replica.
Kilo-Org/cloud#7937	Internal auto-routing benchmark admission and alias hardening.
Kilo-Org/cloud#8091	Internal gateway rename of Kilo-exclusive restriction to inference_providers.
Kilo-Org/cloud#7983	Infrastructure capacity increase for cloud-agent sandbox disk; not a documented workflow.
Kilo-Org/cloud#7716	Fix making the gateway /api/v1/providers endpoint list already-supported providers; internal API behavior.
Kilo-Org/kilocode#15245	Internal follow-up fix mapping audio formats in custom router decision input.
Kilo-Org/cloud#8108	Admin table width fix for request logging opt-in IDs; internal UI polish.
Kilo-Org/cloud#8098	Internal fix to owner pool conversion fetch redirect mode in production.
Kilo-Org/cloud#8109	Internal admin-only change disabling manual provider sync in production.
Kilo-Org/cloud#8074	Internal usage-ingest staging configuration change.
Kilo-Org/cloud#8081	Opt-in queued usage accounting gated to staging; not user-visible.
Kilo-Org/cloud#8075	Internal auto-routing benchmark scheduler finalization fix.
Kilo-Org/cloud#8084	Internal auto-routing service follow-up fixes to custom router cloud routes.
Kilo-Org/kilocode#15246	Internal startup-time ratchet and CI budget scaffolding.
Kilo-Org/kilocode#15248	Startup performance change to show Kilo modes immediately; no workflow or setting change.
Kilo-Org/cloud#7564	Janitor dedupe of provider-review error classification.
Kilo-Org/cloud#7708	Janitor dedupe of cloud-agent git URL utilities.
Kilo-Org/cloud#7331	Janitor pruning of tautological extension tests.
Kilo-Org/cloud#7239	Janitor dedupe of bounded stream body reads in git-token-service.
Kilo-Org/cloud#7192	Internal refactor consolidating duplicate internal API secret auth into a shared helper; no user-visible behavior.
Kilo-Org/cloud#7344	Dependency override to patch a build-time vulnerability; no user-facing change.
Kilo-Org/cloud#7768	Staging-only SSRF/URL policy enforcement for the AI gateway; not enabled in production and no user-facing setting.
Kilo-Org/cloud#8115	Improves BYOK error message text to include the provider explanation; only error wording changes, no workflow change.
Kilo-Org/cloud#7538	Internal admin UI for Vercel model ID overrides that is not used for routing yet; admin-only and not user-visible.
Kilo-Org/cloud#8088	Internal admin tooling for bot users with short-lived token minting; not end-user facing.
Kilo-Org/cloud#8129	Internal change to the auto-routing pool notification campaign discovery; no user-facing behavior.
Kilo-Org/cloud#7938	Removes an internal release gate to route all users through the Frontier benchmark router; a rollout that users do not need to learn to use.
Kilo-Org/cloud#8120	Internal gastown service change requiring a feature-flag claim for town creation; not part of the documented product surface.
Kilo-Org/cloud#8123	Internal observability alerting for Cloudflare container allocations; infrastructure only.
Kilo-Org/cloud#7562	Dependency version bumps fixing Dependabot alerts; no user-facing change.
Kilo-Org/cloud#7838	Comment-only cleanup in the cloud-agent-next web UI; no code or behavior change.
Kilo-Org/cloud#7330	Removes an unused dependency; no user-facing change.
Kilo-Org/cloud#7521	Removes an unused devDependency; no user-facing change.
Kilo-Org/cloud#7240	Removes an unused dependency; no user-facing change.
Kilo-Org/cloud#8130	Internal clone-timeout performance fix using blobless clones; no documented behavior or setting change.
Kilo-Org/cloud#8121	Adds structured logging/instrumentation to usage writes and queue processing; internal telemetry only.
Kilo-Org/cloud#7989	Removes an unused internal diagnostic endpoint; no user-facing change.
Kilo-Org/cloud#8142	Records platform admin actions in an audit log and Axiom; internal admin tooling, not end-user documentation.
Kilo-Org/cloud#8141	Adds an internal admin_action_audit_logs table; database plumbing with no user-visible behavior.
Kilo-Org/cloud#8144	Internal cloud-agent terminal retry/route plumbing fix with no user-facing setting or workflow change.
Kilo-Org/cloud#8150	Internal admin audit logging for the org access bypass; not user-visible product behavior.
Kilo-Org/cloud#8147	Internal sandbox cleanup optimization to avoid waking stopped containers; no user-visible change.
Kilo-Org/kilocode#15257	Fixes a flaky telemetry CI test; no product behavior change.
Kilo-Org/cloud#8151	Removes the internal auto-triage service; internal ops tooling rather than a documented user workflow.
Kilo-Org/kilocode#15254	Bug fix restoring already-documented subagent edit/write behavior for allowlist callers; no new user-facing config.
Kilo-Org/kilocode#15261	Internal Kilo v2 refactor moving the Gateway RPC into the plugin and Schema; no user-visible change.
Kilo-Org/kilocode#15270	In-progress Kilo v2 migration changing internal data directories; not yet user-visible.
Kilo-Org/kilocode#15018	V2 core config discovery of kilo.json/.kilo. Behavior is present in packages/core/src/config.ts but is identical to the already-documented config file locations and precedence for the shipped product (pages/getting-started/settings/index.md); no new user-visible behavior to document.
Kilo-Org/kilocode#15205	Adds internal /kilocode/agent-usage HTTP endpoints and generated SDK types for IDE clients. The docs site has no user-facing HTTP/SDK API reference for the local server, so there is no page or audience to document this for.
Kilo-Org/cloud#8156	The removed MCP Gateway web feature was never documented in packages/kilo-docs (no MCP Gateway page, nav entry, or mention anywhere; the existing MCP docs cover the CLI/extension MCP server configuration only), so there is nothing user-facing to remove or correct.
Kilo-Org/cloud#7975	Internal BYOK gateway routing change. Cloud PR, so verification is limited to the diff and body, and those conflict: the patch excerpt adds zeroDataRetention to the caller-key gateway options while the PR body states it is removed and that a zero-data-retention request now returns a 400. The request-level provider data-handling options (zdr, data_collection) are also not documented on any gateway page, so the merged behavior cannot be documented accurately.

---

(bot) Generated by the docs-sync workflow. Humans review and merge; while this PR stays open, the next daily run appends new changes here. Branch: docs/auto-sync-2026-10-20.

[vercel]

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

Project	Deployment	Actions	Updated
docs (docs-staging)	Ready	Preview	Oct 20, 2026 7:19am UTC

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)

• packages/kilo-docs/LEARNINGS.md - 3 rewritten docs-sync learning rules; prose-only, no code, no images, no config or schema changes.

---

_{Reviewed by deepseek-v4.1-flash · Input: 34.5K · Output: 2.6K · Cached: 186.1K}

_{Review guidance: REVIEW.md from base branch main}