From 97f3d80e4bef1eeebe2848e3513e45751e7a11e8 Mon Sep 17 00:00:00 2001 From: Dennis Meister Date: Mon, 2 Mar 2026 15:30:23 +0100 Subject: [PATCH] docs: update kilo for slack part with gitlab --- .../pages/automate/code-reviews/github.md | 10 +- .../pages/automate/code-reviews/gitlab.md | 43 +----- .../pages/automate/code-reviews/overview.md | 2 +- .../kilo-docs/pages/automate/integrations.md | 133 +++++++++++++++--- .../pages/code-with-ai/platforms/slack.md | 19 ++- 5 files changed, 133 insertions(+), 74 deletions(-) diff --git a/packages/kilo-docs/pages/automate/code-reviews/github.md b/packages/kilo-docs/pages/automate/code-reviews/github.md index f967dabceb..74d4cde482 100644 --- a/packages/kilo-docs/pages/automate/code-reviews/github.md +++ b/packages/kilo-docs/pages/automate/code-reviews/github.md @@ -17,15 +17,7 @@ Kilo's Code Reviews integrate with GitHub via a **GitHub App** to automatically ### Step 1: Install the GitHub App -1. Go to the **Integrations** page: - - **Personal**: [app.kilo.ai/integrations/github](https://app.kilo.ai/integrations/github) - - **Organization**: Your organization → Integrations → GitHub -2. Click **Install GitHub App** -3. Choose which GitHub account or organization to install the app on -4. Select repository access: - - **All repositories** — the app can access all current and future repos - - **Only select repositories** — choose specific repos -5. Click **Install** +Connect your GitHub account via the [Integrations page](../integrations#connecting-github). Once connected, return here to configure the Review Agent. The GitHub App requests the following permissions: diff --git a/packages/kilo-docs/pages/automate/code-reviews/gitlab.md b/packages/kilo-docs/pages/automate/code-reviews/gitlab.md index 4d795e1771..6b44338e4a 100644 --- a/packages/kilo-docs/pages/automate/code-reviews/gitlab.md +++ b/packages/kilo-docs/pages/automate/code-reviews/gitlab.md @@ -21,48 +21,9 @@ Both **GitLab.com** and **self-hosted GitLab instances** are supported. ### Step 1: Connect GitLab -You can connect using **OAuth** or a **Personal Access Token (PAT)**. Choose the method that matches your GitLab setup: +Connect your GitLab account via the [Integrations page](../integrations#connecting-gitlab). You can use **OAuth** (GitLab.com or self-hosted) or a **Personal Access Token (PAT)**. -{% tabs %} -{% tab label="OAuth (GitLab.com)" %} - -1. Go to the **Integrations** page: - - **Personal**: [app.kilo.ai/integrations/gitlab](https://app.kilo.ai/integrations/gitlab) - - **Organization**: Your organization → Integrations → GitLab -2. Click **Connect GitLab** -3. Authorize the application on GitLab -4. You'll be redirected back to Kilo with the connection active - -{% /tab %} -{% tab label="OAuth (Self-Hosted)" %} - -For self-hosted GitLab instances using OAuth, you need to register an OAuth application first: - -1. In your GitLab instance, go to **Admin Area → Applications** (or **User Settings → Applications**) -2. Create a new application: - - **Name**: `Kilo Code` - - **Redirect URI**: `https://app.kilo.ai/api/integrations/gitlab/callback` - - **Scopes**: `api`, `read_user`, `read_repository`, `write_repository` - - **Confidential**: Yes -3. Copy the **Application ID** and **Secret** -4. In Kilo, go to the GitLab integration page -5. Enter your **Instance URL**, **Client ID**, and **Client Secret** -6. Click **Connect** and authorize - -{% /tab %} -{% tab label="Personal Access Token" %} - -1. In GitLab, go to **User Settings → Access Tokens** -2. Create a token with the `api` scope -3. Copy the token -4. In Kilo, go to the GitLab integration page -5. Paste the token (and enter your Instance URL for self-hosted) -6. Click **Connect** - -> PAT tokens cannot be refreshed automatically. When your token expires, create a new one in GitLab and reconnect in Kilo. - -{% /tab %} -{% /tabs %} +Once connected, return here to configure the Review Agent. ### Step 2: Configure the Review Agent diff --git a/packages/kilo-docs/pages/automate/code-reviews/overview.md b/packages/kilo-docs/pages/automate/code-reviews/overview.md index 25d4bdfa27..6dfe6a0082 100644 --- a/packages/kilo-docs/pages/automate/code-reviews/overview.md +++ b/packages/kilo-docs/pages/automate/code-reviews/overview.md @@ -26,7 +26,7 @@ Kilo's **Code Reviews** feature automatically analyzes your pull or merge reques Before enabling Code Reviews: -- **A platform integration must be configured:** Connect your GitHub or GitLab account via the [Integrations page](https://app.kilo.ai/integrations) so that the Review Agent can access your repositories. +- **A platform integration must be configured:** Connect your GitHub or GitLab account via the [Integrations page](https://app.kilo.ai/integrations) so that the Review Agent can access your repositories. See the [Integration setup guide](../integrations) for detailed instructions. - **Kilo Code credits:** The AI model uses credits when analyzing your code. ## Cost diff --git a/packages/kilo-docs/pages/automate/integrations.md b/packages/kilo-docs/pages/automate/integrations.md index b9468a8f3b..58960b1d6a 100644 --- a/packages/kilo-docs/pages/automate/integrations.md +++ b/packages/kilo-docs/pages/automate/integrations.md @@ -5,32 +5,42 @@ description: "Overview of Kilo Code integrations" # Kilo Code Integrations -Kilo Integrations lets you connect your GitHub account (and soon, GitLab and Bitbucket) to enable advanced features inside Kilo Code. Once connected, Kilo can access your repositories securely through the **KiloConnect** GitHub App, enabling features like **Cloud Agents** and **Kilo Deploy**. +Kilo Integrations lets you connect your GitHub or GitLab account (soon Bitbucket) to enable advanced features inside Kilo Code. Once connected, Kilo can access your repositories securely, enabling features like **Code Reviews**, **Cloud Agents**, and **Kilo Deploy**. + +## Supported Platforms + +| Platform | Integration Type | Details | +| -------- | ---------------- | --------------------------------- | +| GitHub | GitHub App | [GitHub Setup](#connecting-github)| +| GitLab | OAuth or PAT | [GitLab Setup](#connecting-gitlab)| ## What You Can Do With Integrations -- **Connect GitHub to Kilo Code** in a few clicks -- **Authorize the KiloConnect App** for repo access -- **Enable advanced features** like Cloud Agents and Kilo Deploy +- **Connect GitHub or GitLab to Kilo Code** in a few clicks +- **Enable advanced features** like Cloud Agents, Code Reviews, and Kilo Deploy +- **Authorize repository access** so Kilo can analyze and work with your code ## Prerequisites Before connecting: -- You must have a **GitHub account**. -- You need permission to install GitHub Apps for the repositories you want Kilo to access. -- (Optional) If you're connecting an organization, you must be an **org admin** or have app installation permissions. +- You must have a **GitHub** or **GitLab** account. +- For GitHub: You need permission to install GitHub Apps for the repositories you want Kilo to access. +- For GitLab: You need **Maintainer** role (or higher) on the projects you want to connect. +- (Optional) If you're connecting an organization, you must be an admin or have app installation permissions. -## Connecting GitHub to Kilo +--- + +## Connecting GitHub ### 1. Open the Integrations Page -Go to your **Personal** or **Organization Dashboard**, and navigate to the [Integrations](https://app.kilo.ai/integrations) tab +Go to your **Personal** or **Organization Dashboard**, and navigate to the [Integrations](https://app.kilo.ai/integrations) tab. ### 2. Start the Connection Flow 1. Click **Configure** on the GitHub panel. -2. You’ll be redirected to GitHub to authorize the **KiloConnect** App. +2. You'll be redirected to GitHub to authorize the **KiloConnect** App. 3. Select the GitHub account or organization you want to connect. ### 3. Choose Repository Access @@ -46,13 +56,62 @@ Click **Install & Authorize** to continue. Once approved: -- You’ll return to the Kilo Integrations page. -- Github will show a **Connected** status. +- You'll return to the Kilo Integrations page. +- GitHub will show a **Connected** status. - Your Kilo workspace can now access GitHub repositories securely. +--- + +## Connecting GitLab + +You can connect GitLab using **OAuth** or a **Personal Access Token (PAT)**. Both **GitLab.com** and **self-hosted GitLab instances** are supported. + +{% tabs %} +{% tab label="OAuth (GitLab.com)" %} + +1. Go to the **Integrations** page: + - **Personal**: [app.kilo.ai/integrations/gitlab](https://app.kilo.ai/integrations/gitlab) + - **Organization**: Your organization → Integrations → GitLab +2. Click **Connect GitLab** +3. Authorize the application on GitLab +4. You'll be redirected back to Kilo with the connection active + +{% /tab %} +{% tab label="OAuth (Self-Hosted)" %} + +For self-hosted GitLab instances using OAuth, you need to register an OAuth application first: + +1. In your GitLab instance, go to **Admin Area → Applications** (or **User Settings → Applications**) +2. Create a new application: + - **Name**: `Kilo Code` + - **Redirect URI**: `https://app.kilo.ai/api/integrations/gitlab/callback` + - **Scopes**: `api`, `read_user`, `read_repository`, `write_repository` + - **Confidential**: Yes +3. Copy the **Application ID** and **Secret** +4. In Kilo, go to the GitLab integration page +5. Enter your **Instance URL**, **Client ID**, and **Client Secret** +6. Click **Connect** and authorize + +{% /tab %} +{% tab label="Personal Access Token" %} + +1. In GitLab, go to **User Settings → Access Tokens** +2. Create a token with the `api` scope +3. Copy the token +4. In Kilo, go to the GitLab integration page +5. Paste the token (and enter your Instance URL for self-hosted) +6. Click **Connect** + +> PAT tokens cannot be refreshed automatically. When your token expires, create a new one in GitLab and reconnect in Kilo. + +{% /tab %} +{% /tabs %} + +--- + ## What Happens After Connecting -Once GitHub is connected, the following features will be enabled in Kilo: +Once your Git provider is connected, the following features are enabled in Kilo: ### Cloud Agents @@ -60,6 +119,12 @@ Once GitHub is connected, the following features will be enabled in Kilo: - Auto-create branches and push work continuously - Work from anywhere while keeping your repo in sync +### Code Reviews + +- Automated AI review on every pull request or merge request +- Consistent feedback based on your team's standards +- See the [Code Reviews guide](/automate/code-reviews/overview) for setup + ### Kilo Deploy - Deploy Next.js 14 & 15 apps directly from Kilo @@ -68,29 +133,61 @@ Once GitHub is connected, the following features will be enabled in Kilo: ### Upcoming: -- **GitLab Integration** - **Bitbucket Integration** --- ## Managing or Removing the Integration -From the same **Integrations** page, you can click "Manage on Github" to: +### GitHub + +From the **Integrations** page, click "Manage on GitHub" to: - View the GitHub account you connected - Update which repositories Kilo has access to - Disconnect GitHub entirely - Reauthorize the app if permissions change +### GitLab + +From the **Integrations** page: + +- Click **Disconnect** to remove the GitLab connection +- Your tokens are cleared, but webhook configuration is preserved so reconnecting restores your setup + +> Disconnecting from Kilo does not revoke OAuth tokens on GitLab's side. You can manually revoke them from **GitLab → User Settings → Applications → Authorized Applications**. + --- ## Troubleshooting -**“I don’t see my repositories.”** +### GitHub + +**"I don't see my repositories."** Ensure the KiloConnect App is installed for the correct GitHub org and that repo access includes the repositories you need. -**“My organization blocks third-party apps.”** +**"My organization blocks third-party apps."** You may need an admin to approve installing GitHub Apps. -**“Cloud Agents or Deploy can’t access my repo.”** +**"Cloud Agents or Deploy can't access my repo."** Revisit the GitHub app settings and confirm the app has the correct repo scope. + +### GitLab + +**"No projects listed after connecting."** +Click the refresh button to sync projects from GitLab. Ensure your GitLab account has access to the projects you expect. + +**"Permission denied" errors.** +You need **Maintainer role** on the GitLab project for webhook and bot token creation. + +**"Token expired."** + +- **OAuth**: Tokens refresh automatically. If refresh fails, reconnect from the integration page. +- **PAT**: Create a new token in GitLab and reconnect in Kilo. + +**"Self-hosted connection issues."** + +- Verify your instance URL is accessible from the internet +- Ensure HTTPS is configured +- Check that OAuth application scopes include all required scopes +- Verify the redirect URI matches: `https://app.kilo.ai/api/integrations/gitlab/callback` diff --git a/packages/kilo-docs/pages/code-with-ai/platforms/slack.md b/packages/kilo-docs/pages/code-with-ai/platforms/slack.md index 43b8bec5da..eca1d4c83c 100644 --- a/packages/kilo-docs/pages/code-with-ai/platforms/slack.md +++ b/packages/kilo-docs/pages/code-with-ai/platforms/slack.md @@ -18,12 +18,21 @@ Kilo for Slack brings the power of Kilo Code directly into your Slack workspace. --- +## Supported Platforms + +| Platform | Integration Type | Details | +| -------- | ---------------- | --------------------------------------------------------------------| +| GitHub | GitHub App | [GitHub Setup Guide](/docs/automate/integrations#connecting-github) | +| GitLab | OAuth or PAT | [GitLab Setup Guide](/docs/automate/integrations#connecting-gitlab) | + +--- + ## Prerequisites Before using Kilo for Slack: - You must have a **Kilo Code account** with available credits -- Your **GitHub Integration must be configured** via the [Integrations tab](https://app.kilo.ai/integrations) so Kilo can access your repositories +- Your **Git provider integration must be configured** via the [Integrations tab](https://app.kilo.ai/integrations) so Kilo can access your repositories To install Kilo for Slack, simply go to the integrations menu in the sidebar on https://app.kilo.ai and set up the Slack integration. @@ -105,9 +114,9 @@ Can you help me understand what's causing it? ## How It Works 1. **Message Kilo** — Either through DMs or by mentioning it in a channel -2. **Kilo processes your request** — Kilo uses your connected GitHub repositories to understand context +2. **Kilo processes your request** — Kilo uses your connected repositories to understand context 3. **AI generates a response** — Kilo Code's AI analyzes your request and provides helpful responses -4. **Code changes (if requested)** — For implementation requests, Kilo can create pull requests +4. **Code changes (if requested)** — For implementation requests, Kilo can create pull or merge requests --- @@ -157,10 +166,10 @@ Kilo for Slack supports over 400+ models across different providers. Ensure Kilo for Slack is installed in your workspace and has been added to the channel you're using. **"Kilo can't access my repository."** -Verify your GitHub integration is configured correctly in the [Integrations tab](https://app.kilo.ai/integrations). +Verify your Git provider integration is configured correctly in the [Integrations tab](https://app.kilo.ai/integrations). **"I'm getting incomplete responses."** Try breaking your request into smaller, more specific questions. **"Kilo doesn't understand my codebase."** -Make sure the repository you're asking about is connected and accessible through your GitHub integration. +Make sure the repository you're asking about is connected and accessible through your Git provider integration.