docs: sync with merged PRs (2026-10-09)

2026-10-13 07:47:46 +08:00 · 2026-10-09 07:21:47 +00:00
parent e2f3de8c2d
commit 845fec4503
5 changed files with 14 additions and 4 deletions
@@ -8,7 +8,7 @@ branch, so the rule is gone from its input, and the deletion itself is a correct
 extraction step is instructed not to undo.

 <!-- docs-sync:learnings:start -->
- Explain why a required flag or option is needed rather than only stating that it is required. <!-- id=explain-required-flags scope=edit source=comment:4046075608 date=2026-09-18 -->
- Note when items created before a behavior change, such as older links or shares, may need to be retried. <!-- id=document-legacy-link-retries scope=edit source=comment:4053112613 date=2026-09-19 -->
- Link each listed item to the source change it documents when the introduction promises such references. <!-- id=fulfill-promised-references scope=edit source=comment:4053902533 date=2026-09-19 -->
+- Explain why a flag or option is needed, not just that it exists. <!-- id=explain-flag-purpose scope=edit source=comment:4046075608 date=2026-09-18 -->
+- Link the relevant reference documentation when describing platform-specific actions or shortcuts so the mapping is obvious. <!-- id=link-related-reference-docs scope=edit source=comment:4044915525 date=2026-09-18 -->
+- State which plans and billing periods a fee applies to, including whether it covers annual plans, renewals, or only new monthly purchases. <!-- id=scope-fee-by-plan scope=edit source=comment:4045668762 date=2026-09-18 -->
 <!-- docs-sync:learnings:end -->
@@ -28,6 +28,12 @@ The VS Code window must be trusted before you can add, create, or clone a reposi

 If you select a folder that is not a Git repository, **Open local folder...** asks whether to initialize Git and create an empty first commit before it adds the project.

+## Reorder projects
+
+Drag a project header in the **PROJECTS** list to move that project up or down. A thin line shows where the project will land, and the new order is saved right away and applied to every VS Code window.
+
+The default project is pinned to the first position and cannot be dragged. The order you set persists across restarts.
+
 ## Project scope

 Each project keeps its own state:
@@ -362,6 +362,8 @@ Renaming a worktree changes only the label shown in Agent Manager. It does not r

 Kilo can start Agent Manager sessions from chat with the `agent_manager` tool. It is available by default only in the VS Code extension because Agent Manager is an extension feature.

+Kilo starts these sessions only when you explicitly ask for new Agent Manager sessions or worktrees, or after it confirms with you first. It does not start them on its own to parallelize or organize routine work: each session is user-visible and each worktree uses disk space and tokens.
+
 The tool supports two modes:

 | Mode | Behavior |
@@ -22,6 +22,8 @@ Browser automation is built into the extension and requires no manual setup. Ena
 The experimental **Integrated Browser** under **Settings → Experimental** is a different feature. It shows local application previews inside Agent Manager and does not replace Playwright browser automation. The two features have independent settings.
 {% /callout %}

+Chat links follow the Integrated Browser's **Open links in** setting under **Settings → Experimental**. When it is set to open links in the Integrated Browser, a plain click opens an `http(s)` link from a Kilo chat in the Integrated Browser. To open that link in your system browser instead, hold **Shift** as you click. Choosing **System browser** for **Open links in** sends every chat link to your system browser, so Shift-click changes nothing.
+
 {% /tab %}
 {% tab label="CLI" %}

@@ -86,7 +86,7 @@ The app follows your device language, with English as the fallback. Choose anoth

 For Kilo Pass pricing, billing, and account management details, use the [Kilo Pass pricing page](https://kilo.ai/pricing/kilo-pass).

-On Android, you can buy, restore, and change Kilo Pass tiers through Google Play. Tier changes take effect at the next renewal; your current tier and credits stay in place until then. Google manages cancellation and payment methods for passes purchased through Google Play.
+Kilo Pass is not sold inside the iOS or Android app. Subscribe to or change your Kilo Pass on the web instead. If you try to buy a Kilo Pass in the app, it shows **Kilo Pass purchase is not available right now.** The Android app can open the web to manage a Kilo Pass you already have; the iOS app does not offer that link.

 ### Buying credits in the app