diff --git a/packages/kilo-docs/components/TopNav.tsx b/packages/kilo-docs/components/TopNav.tsx
index 3d458227c40..2eb4d566f19 100644
--- a/packages/kilo-docs/components/TopNav.tsx
+++ b/packages/kilo-docs/components/TopNav.tsx
@@ -336,8 +336,8 @@ export function TopNav({ onMobileMenuToggle, isMobileMenuOpen = false, showMobil
       {/* Announcement banner */}
       <div className="announcement-banner">
         <p>
-          We've <Link href="https://blog.kilo.ai/p/kilo-cli">replatformed our extensions on the new Kilo CLI</Link>.
-          Contribute at <Link href="https://github.com/Kilo-Org/kilocode">Kilo-Org/kilocode</Link>.
+          Upgraded to the new extension? Check our <Link href="/code-with-ai/new-version-faq">New Version FAQ</Link> for
+          answers to common questions →
         </p>
       </div>
 
diff --git a/packages/kilo-docs/lib/nav/code-with-ai.ts b/packages/kilo-docs/lib/nav/code-with-ai.ts
index e5d621b250f..727b4d0d626 100644
--- a/packages/kilo-docs/lib/nav/code-with-ai.ts
+++ b/packages/kilo-docs/lib/nav/code-with-ai.ts
@@ -6,6 +6,7 @@ export const CodeWithAiNav: NavSection[] = [
     links: [
       { href: "/code-with-ai", children: "Overview" },
       { href: "/code-with-ai/platforms/vscode", children: "VS Code Extension" },
+      { href: "/code-with-ai/new-version-faq", children: "New Version FAQ" },
       {
         href: "/code-with-ai/platforms/jetbrains",
         children: "JetBrains Extension",
diff --git a/packages/kilo-docs/pages/code-with-ai/new-version-faq.md b/packages/kilo-docs/pages/code-with-ai/new-version-faq.md
new file mode 100644
index 00000000000..fb171f24f3a
--- /dev/null
+++ b/packages/kilo-docs/pages/code-with-ai/new-version-faq.md
@@ -0,0 +1,56 @@
+---
+title: "New Version FAQ"
+description: "Common questions and answers about the new Kilo Code VS Code extension version"
+---
+
+# New Version FAQ
+
+If you've recently upgraded to the new Kilo Code VS Code extension (built on the Kilo CLI), you may notice some changes. This FAQ addresses the most common questions about the new version.
+
+## Where did code indexing go?
+
+Code indexing is temporarily unavailable in the new extension. It is actively being worked on and is expected to return soon.
+
+## How do checkpoints work in the new extension?
+
+Checkpoints are available in the new extension. You can use them to save and restore your workspace state during a task. See the [Checkpoints documentation](/docs/code-with-ai/features/checkpoints) for details on how to use them.
+
+## Where is the auto-confirm commands settings UI?
+
+The auto-confirm commands settings have moved to the new settings panel. The UI has changed, but the functionality is the same. Open the settings panel to configure which commands are auto-approved. See [Auto-Approving Actions](/docs/getting-started/settings/auto-approving-actions) for more information.
+
+## Where did the file reading settings go?
+
+File reading settings are available in the new settings panel. Open settings to configure file reading behavior.
+
+## Where is the UI for configuring local LLM providers?
+
+Local LLM providers can be configured through the new settings panel. See the [Local Models](/docs/automate/extending/local-models) documentation for setup instructions.
+
+## The model selection feels bloated. Can I simplify it?
+
+Model selection has been streamlined in the new extension. You can configure your preferred models to reduce clutter. See [Model Selection](/docs/code-with-ai/agents/model-selection) for details on how to customize which models appear in the selector.
+
+## Is the context progress graph still available?
+
+The context progress graph is being evaluated for the new extension. This feature may be reintroduced in a future update.
+
+## Where are the copy buttons in chat?
+
+Copy functionality is available in the chat interface. Hover over a message or code block to reveal the copy button.
+
+## Where did the in-chat UI for skills, commands, and MCPs go?
+
+MCP configuration has been migrated to the new settings panel. If you had MCPs configured in the old extension, they are automatically migrated to the new version. You can manage MCP servers, skills, and commands through the settings panel. See [MCP Overview](/docs/customize/mcp/overview) for more information.
+
+## Where is the diff view for file changes?
+
+The diff view is still available when reviewing file changes. When the agent proposes changes to a file, you can review the diff before approving.
+
+## How do I do code reviews in the new extension?
+
+Code reviews follow the CLI workflow in the new extension. See the [CLI documentation](/docs/code-with-ai/platforms/cli) for current instructions. Documentation specific to code reviews in the VS Code extension is being updated.
+
+## Settings include Linux commands that don't exist on Windows
+
+This is a known issue. The default command allowlist currently shows bash/Linux commands regardless of your platform. A fix is being worked on to make the default commands platform-dependent. In the meantime, you can manually edit the command allowlist in your settings to match your operating system.