From 522e4186f61a294fc99cce0168e46fbb083e2596 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 09:59:31 +0000 Subject: [PATCH 1/8] Add PR Reviews nav, permissions warnings, uninstall commands, and rules clarification - Uncomment PR Reviews section in sidebar navigation - Add prominent permissions warning admonition to GitLab and Bitbucket PR Reviews pages (account needs Developer access, not just token scopes) - Add uninstall sections to all IDE and terminal tool tabs in installation page - Clarify Azure DevOps custom rules note and add "For supported providers" qualifier to step 3 Co-Authored-By: Claude Opus 4.6 (1M context) --- .nav.yml | 2 +- code-reviews/configuration/rules.md | 4 +-- code-reviews/get-started/installation.md | 40 ++++++++++++++++++++++++ code-reviews/pr-reviews/bitbucket.md | 3 ++ code-reviews/pr-reviews/gitlab.md | 3 ++ 5 files changed, 49 insertions(+), 3 deletions(-) diff --git a/.nav.yml b/.nav.yml index cf40f721..c611f654 100644 --- a/.nav.yml +++ b/.nav.yml @@ -3,7 +3,7 @@ nav: - ':custom-sparkles: Review Modes': code-reviews/review-modes.md - ':custom-rocket: Get Started': code-reviews/get-started - ':custom-monitor: IDE Reviews': code-reviews/ide-reviews -# - ':custom-git: PR Reviews': code-reviews/pr-reviews + - ':custom-git: PR Reviews': code-reviews/pr-reviews - ':custom-folder: Repo Reviews': code-reviews/repo-reviews - ':custom-terminal: CLI': code-reviews/cli - ':custom-database: External Knowledge': code-reviews/external-knowledge diff --git a/code-reviews/configuration/rules.md b/code-reviews/configuration/rules.md index 32febdf3..07bb60d8 100644 --- a/code-reviews/configuration/rules.md +++ b/code-reviews/configuration/rules.md @@ -28,9 +28,9 @@ To accommodate different workflows, Code Reviews supports two types of rules: ![Connect to GitHub](/images/code-reviews/configuration/rules/rules-01.webp) !!! note - Rule extraction and project-specific learned rules are currently available for GitHub repositories only. GitLab and Bitbucket do not support automatic rule extraction at this time. Azure DevOps does not support custom rules of any kind, including manual rules. + Rule extraction and project-specific learned rules are currently available for GitHub repositories only. GitLab and Bitbucket do not support automatic rule extraction at this time. Azure DevOps repositories in Code Reviews do not support custom rules of any kind, including manual and learned rules. -3. Click **Add review rule** to create custom rules. +3. For supported providers, click **Add review rule** to create custom rules. ![Add review rule button](/images/code-reviews/configuration/rules/rules-02.webp) diff --git a/code-reviews/get-started/installation.md b/code-reviews/get-started/installation.md index 2844aa55..aaab6f44 100644 --- a/code-reviews/get-started/installation.md +++ b/code-reviews/get-started/installation.md @@ -57,6 +57,10 @@ Before getting started, ensure you have: ![Active MCP Tools in VS Code](/images/code-reviews/get-started/installation/vscode/vscode-integration-6.webp) + **Uninstall** + + To remove kluster.ai from VS Code, open the Extensions panel, find **Kluster Code Reviews**, and click **Uninstall**. + === "Cursor" 1. Click the **Add to Cursor** button below. @@ -79,6 +83,10 @@ Before getting started, ensure you have: ![Active MCP Tools in Cursor](/images/code-reviews/get-started/installation/cursor/cursor-integration-2.webp) + **Uninstall** + + To remove kluster.ai from Cursor, open **Settings** > **Extensions**, find **Kluster Code Reviews**, and click **Uninstall**. + === "JetBrains" !!! warning "AI coding agent support" @@ -120,6 +128,10 @@ Before getting started, ensure you have: ![Active kluster.ai plugin in JetBrains](/images/code-reviews/get-started/installation/jetbrains/jetbrains-integration-5.webp) + **Uninstall** + + To remove kluster.ai from your JetBrains IDE, go to **Settings** > **Plugins**, find **kluster.ai**, and click **Uninstall**. Restart the IDE when prompted. + === "Windsurf" 1. Click the **Add to Windsurf** button below. @@ -161,6 +173,10 @@ Before getting started, ensure you have: ![Active MCP Tools in Windsurf](/images/code-reviews/get-started/installation/windsurf/windsurf-integration-7.webp) + **Uninstall** + + To remove kluster.ai from Windsurf, open the Extensions panel, find **Kluster Code Reviews**, and click **Uninstall**. + === "Antigravity" 1. Click the **Add to Antigravity** button below. @@ -198,6 +214,10 @@ Before getting started, ensure you have: ![Active MCP Tools in Antigravity](/images/code-reviews/get-started/installation/antigravity/antigravity-integration-6.webp) + **Uninstall** + + To remove kluster.ai from Antigravity, open the Extensions panel, find **Kluster Code Reviews**, and click **Uninstall**. + ### Terminal tools === "Claude Code" @@ -237,6 +257,14 @@ Before getting started, ensure you have: ![Claude Code Installation Demo](/images/code-reviews/get-started/installation/claudecode/claude.gif) + **Uninstall** + + To remove kluster.ai from Claude Code, run: + + ```bash + npx -y @klusterai/ide-installer@latest uninstall claude + ``` + === "Codex CLI" **Terminal installation** @@ -270,6 +298,14 @@ Before getting started, ensure you have: ![Codex CLI Installation Demo](/images/code-reviews/get-started/installation/codex-cli/codex-cli.gif) + **Uninstall** + + To remove kluster.ai from Codex CLI, run: + + ```bash + npx -y @klusterai/ide-installer@latest uninstall codex + ``` + === "CLI (Standalone)" kluster-cli is a standalone command-line tool that works without an IDE or AI assistant. Install it directly on macOS, Linux, or Windows. @@ -296,6 +332,10 @@ Before getting started, ensure you have: [:octicons-arrow-right-24: CLI quickstart](/code-reviews/cli/quickstart/) + **Uninstall** + + To remove the kluster CLI, see the [CLI installation guide](/code-reviews/cli/installation/) for platform-specific uninstall instructions. + ## Next steps - **[Human-written code](/code-reviews/ide-reviews/human-written-code/on-demand-reviews/)**: Learn about on-demand reviews in your editor diff --git a/code-reviews/pr-reviews/bitbucket.md b/code-reviews/pr-reviews/bitbucket.md index c2937d07..27cc0078 100644 --- a/code-reviews/pr-reviews/bitbucket.md +++ b/code-reviews/pr-reviews/bitbucket.md @@ -20,6 +20,9 @@ Before getting started, ensure you have: - A Bitbucket account with **developer** access to the repositories you want to review. - A Bitbucket API token. See [Create an API token](#create-an-api-token) for instructions. +!!! warning "Verify account permissions" + The account that generates the API token must have at least **developer** access to the target repositories. Having the correct token scopes is not enough — the account itself needs developer-level permissions. If the account has insufficient access, webhook installation will fail and pull request reviews will not appear. After fixing the account's permissions, click **Re-install** on the PR Reviews page in the kluster.ai platform to complete the setup. + ## Create an API token The kluster.ai bot requires a Bitbucket API token to access your repositories and post review comments. Tokens are created through your Atlassian account settings. diff --git a/code-reviews/pr-reviews/gitlab.md b/code-reviews/pr-reviews/gitlab.md index 1c3be3a0..a18d2201 100644 --- a/code-reviews/pr-reviews/gitlab.md +++ b/code-reviews/pr-reviews/gitlab.md @@ -20,6 +20,9 @@ Before getting started, ensure you have: - A GitLab account with at least **Developer** access to the projects you want to review. - A GitLab access token with the `api` scope. See [Create an access token](#create-an-access-token) for instructions. +!!! warning "Verify account permissions" + The account that generates the access token must have at least **Developer** role in the target project or group. Having the correct token scopes (such as `api`) is not enough — the account itself needs Developer-level permissions. If the account only has Guest access, webhook installation will fail silently and PR reviews will not appear. After fixing the account's role, click **Re-install** on the PR Reviews page in the kluster.ai platform to complete the setup. + ## Create an access token The kluster.ai bot requires a GitLab access token with the `api` scope to read merge requests and post review comments. From 2480ee76a063ad430ed7c1eb7d7e53bbbe693402 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 10:15:25 +0000 Subject: [PATCH 2/8] Add Enterprise plan note to PR Reviews pages and snippet Co-Authored-By: Claude Opus 4.6 (1M context) --- .snippets/text/code-reviews/pr-reviews-enterprise.md | 2 ++ code-reviews/pr-reviews/azure-devops.md | 2 ++ code-reviews/pr-reviews/bitbucket.md | 2 ++ code-reviews/pr-reviews/github.md | 2 ++ code-reviews/pr-reviews/gitlab.md | 2 ++ code-reviews/pr-reviews/quickstart.md | 2 ++ 6 files changed, 12 insertions(+) create mode 100644 .snippets/text/code-reviews/pr-reviews-enterprise.md diff --git a/.snippets/text/code-reviews/pr-reviews-enterprise.md b/.snippets/text/code-reviews/pr-reviews-enterprise.md new file mode 100644 index 00000000..ccbbc8e4 --- /dev/null +++ b/.snippets/text/code-reviews/pr-reviews-enterprise.md @@ -0,0 +1,2 @@ +!!! note "Enterprise plan" + PR Reviews is available exclusively on the Enterprise plan. To enable PR Reviews for your organization, contact the kluster.ai team at [info@kluster.ai](mailto:info@kluster.ai){target=\_blank}. \ No newline at end of file diff --git a/code-reviews/pr-reviews/azure-devops.md b/code-reviews/pr-reviews/azure-devops.md index f39345db..9d19dbd7 100644 --- a/code-reviews/pr-reviews/azure-devops.md +++ b/code-reviews/pr-reviews/azure-devops.md @@ -12,6 +12,8 @@ Before connecting, an administrator in your Azure DevOps organization must compl Once connected, the bot reviews every new pull request and every new commit pushed to an open pull request. No additional configuration is needed. +--8<-- 'text/code-reviews/pr-reviews-enterprise.md' + --8<-- 'text/code-reviews/pr-reviews-tip.md' !!! warning "Custom rules not supported" diff --git a/code-reviews/pr-reviews/bitbucket.md b/code-reviews/pr-reviews/bitbucket.md index 27cc0078..5bf4fbcb 100644 --- a/code-reviews/pr-reviews/bitbucket.md +++ b/code-reviews/pr-reviews/bitbucket.md @@ -10,6 +10,8 @@ Connect the [kluster.ai](https://www.kluster.ai/){target=\_blank} bot to your Bi Once connected, the bot reviews every new pull request and every new commit pushed to an open pull request. No additional configuration is needed. +--8<-- 'text/code-reviews/pr-reviews-enterprise.md' + --8<-- 'text/code-reviews/pr-reviews-tip.md' ## Prerequisites diff --git a/code-reviews/pr-reviews/github.md b/code-reviews/pr-reviews/github.md index a16bd8da..ce11d9bc 100644 --- a/code-reviews/pr-reviews/github.md +++ b/code-reviews/pr-reviews/github.md @@ -10,6 +10,8 @@ Connect the [kluster.ai](https://www.kluster.ai/){target=\_blank} bot to your Gi Once connected, the bot reviews every new PR and every new commit pushed to an open PR. No additional configuration is needed. +--8<-- 'text/code-reviews/pr-reviews-enterprise.md' + --8<-- 'text/code-reviews/pr-reviews-tip.md' ## Prerequisites diff --git a/code-reviews/pr-reviews/gitlab.md b/code-reviews/pr-reviews/gitlab.md index a18d2201..af37771d 100644 --- a/code-reviews/pr-reviews/gitlab.md +++ b/code-reviews/pr-reviews/gitlab.md @@ -10,6 +10,8 @@ Connect the [kluster.ai](https://www.kluster.ai/){target=\_blank} bot to your Gi Once connected, the bot reviews every new merge request and every new commit pushed to an open merge request. No additional configuration is needed. +--8<-- 'text/code-reviews/pr-reviews-enterprise.md' + --8<-- 'text/code-reviews/pr-reviews-tip.md' ## Prerequisites diff --git a/code-reviews/pr-reviews/quickstart.md b/code-reviews/pr-reviews/quickstart.md index 29d36b49..5757df60 100644 --- a/code-reviews/pr-reviews/quickstart.md +++ b/code-reviews/pr-reviews/quickstart.md @@ -13,6 +13,8 @@ The bot acts as a last line of defense. It catches issues that were missed durin !!! tip "Best used as a safety net" PR Reviews is most effective when combined with earlier review stages. Install the [kluster.ai extension](/code-reviews/get-started/installation/) in your IDE or set up [CLI hooks](/code-reviews/cli/git-hooks/) to catch issues while you code. The PR bot then confirms nothing was missed. +--8<-- 'text/code-reviews/pr-reviews-enterprise.md' + ## How it works Once installed, the kluster.ai bot triggers automatically in two situations: From 84260fa3da8ac4a9522398d1637365078be5a5a1 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 10:47:18 +0000 Subject: [PATCH 3/8] Fix admonition order on PR Reviews quickstart to match platform pages Enterprise note now appears before the tip, consistent with GitHub, GitLab, Bitbucket, and Azure DevOps pages. Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/quickstart.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code-reviews/pr-reviews/quickstart.md b/code-reviews/pr-reviews/quickstart.md index 5757df60..b1fbef66 100644 --- a/code-reviews/pr-reviews/quickstart.md +++ b/code-reviews/pr-reviews/quickstart.md @@ -10,11 +10,11 @@ PR Reviews connects a [kluster.ai](https://www.kluster.ai/){target=\_blank} bot The bot acts as a last line of defense. It catches issues that were missed during development, whether you used IDE reviews, CLI checks, or no kluster tooling at all. Every PR gets an ultra-deep analysis that examines your changes for bugs, security vulnerabilities, and quality problems before they reach your main branch. +--8<-- 'text/code-reviews/pr-reviews-enterprise.md' + !!! tip "Best used as a safety net" PR Reviews is most effective when combined with earlier review stages. Install the [kluster.ai extension](/code-reviews/get-started/installation/) in your IDE or set up [CLI hooks](/code-reviews/cli/git-hooks/) to catch issues while you code. The PR bot then confirms nothing was missed. ---8<-- 'text/code-reviews/pr-reviews-enterprise.md' - ## How it works Once installed, the kluster.ai bot triggers automatically in two situations: From dcef64e2a3fe8f67db8287d1ebe8cddee4f04e4f Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 11:35:18 +0000 Subject: [PATCH 4/8] Update contact email to sales@kluster.ai in Enterprise snippet Co-Authored-By: Claude Opus 4.6 (1M context) --- .snippets/text/code-reviews/pr-reviews-enterprise.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.snippets/text/code-reviews/pr-reviews-enterprise.md b/.snippets/text/code-reviews/pr-reviews-enterprise.md index ccbbc8e4..1b89e73a 100644 --- a/.snippets/text/code-reviews/pr-reviews-enterprise.md +++ b/.snippets/text/code-reviews/pr-reviews-enterprise.md @@ -1,2 +1,2 @@ !!! note "Enterprise plan" - PR Reviews is available exclusively on the Enterprise plan. To enable PR Reviews for your organization, contact the kluster.ai team at [info@kluster.ai](mailto:info@kluster.ai){target=\_blank}. \ No newline at end of file + PR Reviews is available exclusively on the Enterprise plan. To enable PR Reviews for your organization, contact the kluster.ai team at [sales@kluster.ai](mailto:sales@kluster.ai){target=\_blank}. \ No newline at end of file From c2350479609588526266c7b941df4e06bfec9abf Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 12:56:55 +0000 Subject: [PATCH 5/8] Fix Azure DevOps permissions requirement and add troubleshooting entry Update prerequisites from Basic access to Project Administrator or Project Collection Administrator. Add warning admonition about silent webhook failure. Add troubleshooting section with step-by-step fix. Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/azure-devops.md | 5 ++++- code-reviews/troubleshooting.md | 17 +++++++++++++++++ 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/code-reviews/pr-reviews/azure-devops.md b/code-reviews/pr-reviews/azure-devops.md index 9d19dbd7..96862728 100644 --- a/code-reviews/pr-reviews/azure-devops.md +++ b/code-reviews/pr-reviews/azure-devops.md @@ -24,9 +24,12 @@ Once connected, the bot reviews every new pull request and every new commit push Before getting started, ensure you have: - A [kluster.ai](https://platform.kluster.ai/signup){target=\_blank} account. -- An Azure DevOps account with at least **Basic** access to the projects you want to review. +- An Azure DevOps account with **Project Administrator** or **Project Collection Administrator** permissions in the projects you want to review. - A personal access token with the required scopes. See [Create a personal access token](#create-a-personal-access-token) for instructions. +!!! warning "Verify account permissions" + The account that generates the personal access token must have **Project Administrator** or **Project Collection Administrator** permissions. Having the correct token scopes is not enough — the account itself needs administrator-level permissions to install webhooks. If the account has insufficient permissions, webhook installation will fail silently and pull request reviews will not appear. To fix this, add the user to **Project Collection Administrators** in **Organization Settings** > **Security** > **Permissions**. After updating permissions, click **Re-install** on the PR Reviews page in the kluster.ai platform to complete the setup. + ## Admin consent Before anyone in your organization can connect kluster to Azure DevOps, an administrator or organization owner must grant consent. This is a one-time step per organization that applies to both PR reviews and repo reviews. diff --git a/code-reviews/troubleshooting.md b/code-reviews/troubleshooting.md index 7485c0a1..e5d136de 100644 --- a/code-reviews/troubleshooting.md +++ b/code-reviews/troubleshooting.md @@ -142,6 +142,23 @@ Or split the review by reviewing individual files: kluster review file src/large-file.go ``` +## PR Reviews + +### Azure DevOps PR reviews not appearing + +After connecting Azure DevOps, pull request reviews may not appear if the account used to generate the personal access token lacks the required permissions to install webhooks. + +To fix this: + +1. Navigate to **Azure DevOps** > **Organization Settings** > **Security** > **Permissions**. +2. Find the user account that generated the personal access token. +3. Open the **Member of** tab and add the user to **Project Collection Administrators**. +4. Return to the [PR Reviews](https://platform.kluster.ai/pr-bot-installation){target=\_blank} page in the kluster.ai platform and click **Re-install** on the Azure DevOps integration. + +After re-installing, each new pull request should receive review comments from kluster. + +For more details on the required permissions, see the [Azure DevOps setup guide](/code-reviews/pr-reviews/azure-devops/). + ## Need help? If your issue isn't listed here or you need additional support, join our [Discord community](https://discord.com/invite/klusterai){target=\_blank}. From b63b80c4d2090d770c963c7423fe8cbf3d63119d Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 14:14:18 +0000 Subject: [PATCH 6/8] Align Azure DevOps permissions to Project Collection Administrators only MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Remove ambiguous "Project Administrator or Project Collection Administrator" wording — the fix requires Project Collection Administrators specifically per the support case. Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/pr-reviews/azure-devops.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code-reviews/pr-reviews/azure-devops.md b/code-reviews/pr-reviews/azure-devops.md index 96862728..26a4dceb 100644 --- a/code-reviews/pr-reviews/azure-devops.md +++ b/code-reviews/pr-reviews/azure-devops.md @@ -24,11 +24,11 @@ Once connected, the bot reviews every new pull request and every new commit push Before getting started, ensure you have: - A [kluster.ai](https://platform.kluster.ai/signup){target=\_blank} account. -- An Azure DevOps account with **Project Administrator** or **Project Collection Administrator** permissions in the projects you want to review. +- An Azure DevOps account that is a member of **Project Collection Administrators** in your organization. - A personal access token with the required scopes. See [Create a personal access token](#create-a-personal-access-token) for instructions. !!! warning "Verify account permissions" - The account that generates the personal access token must have **Project Administrator** or **Project Collection Administrator** permissions. Having the correct token scopes is not enough — the account itself needs administrator-level permissions to install webhooks. If the account has insufficient permissions, webhook installation will fail silently and pull request reviews will not appear. To fix this, add the user to **Project Collection Administrators** in **Organization Settings** > **Security** > **Permissions**. After updating permissions, click **Re-install** on the PR Reviews page in the kluster.ai platform to complete the setup. + The account that generates the personal access token must be a member of **Project Collection Administrators**. Having the correct token scopes is not enough — the account itself needs this role to install webhooks. If the account has insufficient permissions, webhook installation will fail silently and pull request reviews will not appear. To fix this, navigate to **Organization Settings** > **Security** > **Permissions**, find the user, and add them to **Project Collection Administrators**. After updating permissions, click **Re-install** on the PR Reviews page in the kluster.ai platform to complete the setup. ## Admin consent From 720aa349637c1f3b4ef869abb082bba40cbb6539 Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 14:14:58 +0000 Subject: [PATCH 7/8] List supported providers explicitly in rules step 3 Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/configuration/rules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code-reviews/configuration/rules.md b/code-reviews/configuration/rules.md index 07bb60d8..106f4e92 100644 --- a/code-reviews/configuration/rules.md +++ b/code-reviews/configuration/rules.md @@ -30,7 +30,7 @@ To accommodate different workflows, Code Reviews supports two types of rules: !!! note Rule extraction and project-specific learned rules are currently available for GitHub repositories only. GitLab and Bitbucket do not support automatic rule extraction at this time. Azure DevOps repositories in Code Reviews do not support custom rules of any kind, including manual and learned rules. -3. For supported providers, click **Add review rule** to create custom rules. +3. For GitHub, GitLab, and Bitbucket providers, click **Add review rule** to create custom rules. ![Add review rule button](/images/code-reviews/configuration/rules/rules-02.webp) From 32195e6ea102f707f234c76d9d9e3880ba86305c Mon Sep 17 00:00:00 2001 From: Alberto Viera Date: Thu, 9 Apr 2026 14:15:35 +0000 Subject: [PATCH 8/8] Use 'kluster.ai bot' consistently in troubleshooting Co-Authored-By: Claude Opus 4.6 (1M context) --- code-reviews/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code-reviews/troubleshooting.md b/code-reviews/troubleshooting.md index e5d136de..3d0a1623 100644 --- a/code-reviews/troubleshooting.md +++ b/code-reviews/troubleshooting.md @@ -155,7 +155,7 @@ To fix this: 3. Open the **Member of** tab and add the user to **Project Collection Administrators**. 4. Return to the [PR Reviews](https://platform.kluster.ai/pr-bot-installation){target=\_blank} page in the kluster.ai platform and click **Re-install** on the Azure DevOps integration. -After re-installing, each new pull request should receive review comments from kluster. +After re-installing, each new pull request should receive review comments from the kluster.ai bot. For more details on the required permissions, see the [Azure DevOps setup guide](/code-reviews/pr-reviews/azure-devops/).