[github-actions]

Automated docs sync — 2026-10-27

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-25T07:03:39.767Z → 2026-10-27T07:10:23.853Z
• Verification (docs build + tests): passing

Surface: gateway

• Assignees / requested reviewers: @chrarnoldus and @lambertjosh
• 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: packages/kilo-gateway/
• Doc prefixes: packages/kilo-docs/pages/gateway/, packages/kilo-docs/pages/ai-providers/
• 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: Reviewers for gateway are ranked from git history over packages/kilo-gateway/ (a commit 180 days old counts half as much, half-life 180 days). Bots (author type "Bot" or a login matching /[bot]$/i) and people without admin, write, or maintain permission are excluded.

Changes

Docs change	Source
updated pages/automate/agent-manager.md	Kilo-Org/kilocode#15482
updated pages/ai-providers/openai-chatgpt-plus-pro.md	Kilo-Org/kilocode#15411
updated pages/code-with-ai/platforms/cli.md	Kilo-Org/kilocode#15426

Pending — will retry

None.

Considered, no docs change needed

PR	Reason
Kilo-Org/cloud#8864	Mobile agent-brief preparation and translation changes are app-internal workflows not covered by kilo.ai product docs.
Kilo-Org/cloud#8749	Mobile briefing settings localization fix with no new documented workflow.
Kilo-Org/cloud#8585	Internal cloud-agent attachment linking and schema plumbing with no user-visible behavior change.
Kilo-Org/cloud#8704	Mobile sign-in screen rebuild on language change is a bug fix inside the mobile app.
Kilo-Org/cloud#8229	Bitbucket inbox pagination hardening is an internal provider-review fix.
Kilo-Org/cloud#8853	Staging usage-queue diagnostics are infrastructure observability work.
Kilo-Org/cloud#8649	Bot repository-binding change is an internal security/plumbing fix with no new user workflow.
Kilo-Org/kilocode#15472	Fixes transcript copy behavior that was already documented, restoring existing functionality.
Kilo-Org/cloud#8902	Hides a sidebar entry behind an existing feature flag, so no documented behavior changes.
Kilo-Org/cloud#8892	Pure internal refactor splitting an ai-gateway module with no behavior change.
Kilo-Org/cloud#8856	Staging-only EU jurisdiction queue configuration and deployment infrastructure.
Kilo-Org/cloud#8876	Internal embedding error-accounting fix with no user-facing setting or workflow.
Kilo-Org/cloud#8875	Internal BYOK cost-accounting correction in the AI gateway.
Kilo-Org/cloud#8851	Staging-only queue concurrency experiment with no documented product behavior.
Kilo-Org/kilocode#15434	Dependency bump fixing watcher CPU usage, with no new user-facing configuration.
Kilo-Org/cloud#8854	Internal Responses API normalization fix in the AI gateway.
Kilo-Org/cloud#8878	Internal billing correction for BYOK embeddings with no user workflow change.
Kilo-Org/cloud#8257	Mobile model-catalog navigation fix inside the mobile app.
Kilo-Org/cloud#8665	Mobile review-memory proposal UI is app-specific and carries a do-not-merge label.
Kilo-Org/cloud#8820	Mobile briefing filter fix with no documented product workflow change.
Kilo-Org/cloud#8027	Internal auth rate-limiter hardening across passkey routes.
Kilo-Org/cloud#8877	Internal transcription cost-accounting fix in the AI gateway.
Kilo-Org/cloud#8195	Internal auth credential-binding security fix with no new user-facing workflow.
Kilo-Org/kilocode#15479	Fixes auto-compaction to match the already-documented threshold_percent behavior rather than introducing new settings.
Kilo-Org/cloud#8900	Internal admin-console comment cleanup; no user-facing behavior.
Kilo-Org/cloud#8898	Removes an orphaned unused component with no consumer.
Kilo-Org/cloud#8857	Internal ai-gateway upstream refactor with no user-visible behavior.
Kilo-Org/cloud#8901	Cloud agent header now shows cost/token usage, but it is a read-only display requiring no new user steps; likely not documented behavior.
Kilo-Org/cloud#8886	Environment snapshots build and restore automatically; transparent performance change with no new user workflow.
Kilo-Org/cloud#8028	Internal slack credential-store fix with no documented behavior change.
Kilo-Org/cloud#8535	Mobile to-do form fix restoring expected behavior; mobile app is not covered by public docs.
Kilo-Org/cloud#8175	Mobile composer navigation dedup fix with no docs impact.
Kilo-Org/cloud#8908	Internal ai-gateway security hardening for public custom LLMs.
Kilo-Org/cloud#8170	Mobile invite-member form reset fix restoring already-expected behavior.
Kilo-Org/cloud#8883	Mobile microphone availability fix with no docs impact.
Kilo-Org/cloud#8850	Mobile tab-switch bug fix; restores behavior with no new learning.
Kilo-Org/cloud#8810	Internal kilo-mcp query-length bound and per-account allowance; not user-documented.
Kilo-Org/cloud#8589	Internal cloud-agent-sdk connection exhaustion/retry plumbing with no user-facing setting.
Kilo-Org/cloud#8538	Internal mobile app-action repository value validation fix.
Kilo-Org/cloud#8450	Internal mobile app-action confirmation fix with no docs impact.
Kilo-Org/cloud#8385	Mobile security-agent link routing fix restoring existing behavior.
Kilo-Org/cloud#8582	Internal widget title sanitization fix with no documented behavior.
Kilo-Org/cloud#8571	Internal credits cursor paging fix; no user-visible behavior change.
Kilo-Org/cloud#8870	Mobile accessibility label fix with no docs impact.
Kilo-Org/cloud#8855	Internal cloud-agent-sdk workspace diagnostics refinement.
Kilo-Org/cloud#8672	Internal bot GitHub conversation history ordering fix.
Kilo-Org/cloud#8569	Mobile composer attachment bounds fix restoring existing behavior.
Kilo-Org/cloud#8232	Internal bot prompt-block formatting change with no user workflow change.
Kilo-Org/cloud#8217	Internal session-ingest cursor size bound fix; no user-visible behavior.
Kilo-Org/cloud#7994	Internal pagination/body-size bounds in the review comment adapter, no user-facing workflow change.
Kilo-Org/cloud#8017	Internal input validation and rate-limit metering for the attribution worker.
Kilo-Org/cloud#8011	Internal performance refactor of dashboard stats queries.
Kilo-Org/cloud#7884	Internal query consolidation in the auto-dismiss service.
Kilo-Org/cloud#8057	Mobile catalog fix; the mobile app is not covered by kilo.ai/docs and it corrects an incorrect existing display.
Kilo-Org/cloud#8184	Stabilizes an internal error message returned by admin credit grants.
Kilo-Org/cloud#7857	Internal observability timing validation and sampling fix.
Kilo-Org/cloud#8910	Internal AI Gateway response transform for reasoning strings; no user-facing setting or workflow.
Kilo-Org/cloud#8911	Staging-only infrastructure change removing a usage relay binding.
Kilo-Org/cloud#8909	Bug fix restoring intended routing of latest-model aliases, no documented behavior change.
Kilo-Org/cloud#8542	Mobile UI fixes for to-do rows and rename modal; mobile app is outside kilo.ai/docs scope.
Kilo-Org/cloud#8912	Internal AI Gateway fix for splitting Gemini thoughts in non-streaming responses.
Kilo-Org/cloud#8532	Internal provider read-layer refactor sharing a file read ceiling; no user-facing setting exposed.
Kilo-Org/cloud#8907	Internal AI Gateway response/usage normalization plumbing.
Kilo-Org/cloud#8178	Internal fix to session live-summary text truncation.
Kilo-Org/cloud#8723	Internal billing fix serializing credit expiration with account usage.
Kilo-Org/cloud#8920	Internal AI Gateway fix adding the missing function type to tool calls.
Kilo-Org/cloud#8925	Internal gateway gating fix aligning BYOK with free-model handling; no new user workflow or setting.
Kilo-Org/cloud#8924	Prep DB migration adding an internal column; no user-visible behavior.
Kilo-Org/cloud#8927	Prep DB migration/schema scaffold for a future BYOK catalog feature; not yet user-visible.
Kilo-Org/cloud#7874	Internal bot fix for GitLab project resolution; restores existing behavior.
Kilo-Org/cloud#7978	Internal preview return-path normalization fix with no documented workflow change.
Kilo-Org/cloud#8006	Internal GitLab review-note identity fix; no user-visible behavior change.
Kilo-Org/cloud#7988	Edge-case mobile MCP profile validation fix; no new documented workflow.
Kilo-Org/cloud#8025	Internal session-ingest cost/liveness plumbing; no user-facing setting or behavior.
Kilo-Org/cloud#8174	Mobile glanceable approval binding bug fix; restores intended behavior.
Kilo-Org/cloud#8245	Android approve now requires device unlock; security hardening of a niche mobile action, not a documented workflow.
Kilo-Org/cloud#8512	Internal GitLab project validation added before session preparation; no user-visible change.
Kilo-Org/cloud#8541	Internal sandbox git credential plumbing change; no user-facing behavior.
Kilo-Org/cloud#7609	Paid-credit expiry is gated by the PAID_CREDIT_EXPIRATION_EFFECTIVE_AT policy setting and is off by default, so new purchases keep non-expiring legacy terms. Documenting one-year expiry now would document unreleased behavior.
Kilo-Org/cloud#8294	The public custom LLM field is configured by Kilo admins in the internal admin panel (apps/web/src/app/admin/custom-llms). Users have no configuration surface, and the public docs do not describe how Kilo curates its model catalog, so there is nothing user-facing to document.
Kilo-Org/cloud#8859	BYOC Vercel compute enrollment is gated by the BYOC_VERCEL_IDS Worker environment variable (comma-separated user/organization IDs; empty disables enrollment), so it is only visible to allowlisted accounts, not the general audience the docs target.
Kilo-Org/cloud#8846	Builds on #7609 and only changes what the credits page states once PAID_CREDIT_EXPIRATION_EFFECTIVE_AT is set; with the policy off the page still reads "Do not expire", so the user-visible credit terms are unchanged.
Kilo-Org/kilocode#15428	Custom auto routers are already documented: pages/code-with-ai/agents/auto-model.md (#custom-auto-routers) and pages/code-with-ai/platforms/cli-reference.md (#kilo-auto) describe kilo-auto/custom/<slug> routers and the kilo auto router list/add/remove and kilo auto eval commands with every option. The current tree (packages/opencode/src/kilocode/cli/cmd/auto.ts) matches what those pages say, so there is no new user-facing behavior to add.
Kilo-Org/cloud#8917	BYOC Vercel compute remains gated by the BYOC_VERCEL_IDS allowlist (the PR's own tests set BYOC_VERCEL_IDS: '*'), so it only refines picker behavior for enrolled accounts, not the general audience the docs target. The parent enrollment change (#8859) was skipped for the same reason, and the public docs already state that Vercel sandboxes are GitHub-only and that Platform default resolves to a named sandbox.
Kilo-Org/cloud#8916	Internal Cloud Agent discovery plumbing: cursor-paginated hosted-workspace RPC/list/get queries in session-ingest plus a workspaceId on root-session summaries. The PR adds no user-facing UI ("N/A - no visual changes"), and the docs do not describe the Cloud workspace catalog that Agent Manager consumes from it.

---

(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-27.

[vercel]

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

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

[kilo-code-bot]

lgtm

Code Review Summary

Status: No Issues Found | Recommendation: Merge

The added CLI guidance matches the current implementation in packages/opencode/src/plugin/openai/codex.ts:557-675: the three method labels, the PKCE browser flow, the device-code headless flow, and the API-key fallback are all described accurately, and the headless caveat lines up with the local callback server on port 1455 (codex.ts:279-351).

Files Reviewed (1 file)

• packages/kilo-docs/pages/ai-providers/openai-chatgpt-plus-pro.md

---

_{Reviewed by deepseek-flash-latest · Input: 43.1K · Output: 4.6K · Cached: 535.6K}

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