diff --git a/.snippets/text/install-button-antigravity.md b/.snippets/text/install-button-antigravity.md
index 68b664f2..ca35734a 100644
--- a/.snippets/text/install-button-antigravity.md
+++ b/.snippets/text/install-button-antigravity.md
@@ -1 +1 @@
-[:octicons-arrow-right-24: Add to Antigravity](antigravity:extension/klusterai.kluster-verify-code){target=\_blank .md-button .md-button--primary}
+[:octicons-arrow-right-24: Add to Antigravity](antigravity-ide:extension/klusterai.kluster-verify-code){target=\_blank .md-button .md-button--primary}
diff --git a/.snippets/text/install-manual-login.md b/.snippets/text/install-manual-login.md
new file mode 100644
index 00000000..a6e32aaf
--- /dev/null
+++ b/.snippets/text/install-manual-login.md
@@ -0,0 +1,7 @@
+If the browser sign-in flow is unavailable or fails, you can log in with an API key instead:
+
+1. Open the [kluster.ai platform](https://platform.kluster.ai){target=\_blank} and sign in.
+2. Click your user menu in the top-right corner.
+3. Select **Manual IDE login**.
+4. Copy the displayed key.
+5. Paste the key into the API key field in your IDE's kluster.ai panel.
diff --git a/code-reviews/get-started/installation.md b/code-reviews/get-started/installation.md
index 8b1f25a3..76b823b0 100644
--- a/code-reviews/get-started/installation.md
+++ b/code-reviews/get-started/installation.md
@@ -20,7 +20,7 @@ Before getting started, ensure you have:
 
 ### IDE extensions
 
-=== "VS Code / Codex VS Code"
+=== "VS Code / Codex"
 
     **Install**
 
@@ -53,6 +53,9 @@ Before getting started, ensure you have:
 
         ![Open and Install MCP](/images/code-reviews/get-started/installation/vscode/vscode-integration-5.webp)
 
+    !!! tip "Sign-in not working?"
+        If the browser sign-in handoff doesn't complete, [log in manually with an API key](#__tabbed_1_8) instead.
+
     **Enable**
 
     Once signed in, to enable kluster.ai in the VS Code agent chat window, take the following steps:
@@ -91,6 +94,9 @@ Before getting started, ensure you have:
 
         ![Active MCP Tools in Cursor](/images/code-reviews/get-started/installation/cursor/cursor-integration-2.webp)
 
+    !!! tip "Sign-in not working?"
+        If the browser sign-in handoff doesn't complete, [log in manually with an API key](#__tabbed_1_8) instead.
+
     **Uninstall**
 
     To remove kluster.ai from Cursor, open **Settings** > **Extensions**, find **Kluster Code Reviews**, and click **Uninstall**.
@@ -259,6 +265,9 @@ Before getting started, ensure you have:
 
         ![Active MCP Tools in Windsurf](/images/code-reviews/get-started/installation/windsurf/windsurf-integration-7.webp)
 
+    !!! tip "Sign-in not working?"
+        If the browser sign-in handoff doesn't complete, [log in manually with an API key](#__tabbed_1_8) instead.
+
     **Uninstall**
 
     To remove kluster.ai from Windsurf, open the Extensions panel, find **Kluster Code Reviews**, and click **Uninstall**.
@@ -304,6 +313,9 @@ Before getting started, ensure you have:
 
         ![Active MCP Tools in Antigravity](/images/code-reviews/get-started/installation/antigravity/antigravity-integration-6.webp)
 
+    !!! tip "Sign-in not working?"
+        If the browser sign-in handoff doesn't complete, [log in manually with an API key](#__tabbed_1_8) instead.
+
     **Uninstall**
 
     To remove kluster.ai from Antigravity, open the Extensions panel, find **Kluster Code Reviews**, and click **Uninstall**.
@@ -344,6 +356,9 @@ Before getting started, ensure you have:
 
         ![Authorize MCP install in Kiro](/images/code-reviews/get-started/installation/kiro/kiro-integration-5.webp)
 
+    !!! tip "Sign-in not working?"
+        If the browser sign-in handoff doesn't complete, [log in manually with an API key](#__tabbed_1_8) instead.
+
     **Enable MCP**
 
     By default, Kiro disables MCP for all extensions. You must enable it before kluster can run. This is a one-time setup at the IDE level — once you click **Enable MCP**, every current and future MCP-based extension in Kiro can run, so you don't need to repeat this step for other tools.
@@ -367,6 +382,12 @@ Before getting started, ensure you have:
 
     To remove kluster.ai from Kiro, open the Extensions panel, find **Kluster Code Reviews**, and click **Uninstall**.
 
+=== "Manual login"
+
+    Most IDEs sign you in through a browser handoff. If that flow is unavailable or fails in your editor (VS Code, Cursor, Windsurf, Antigravity, or Kiro), use the manual API-key login below.
+
+    --8<-- 'text/install-manual-login.md'
+
 ### Terminal tools
 
 === "Claude Code"