mirror of
https://github.com/Kilo-Org/kilocode.git
synced 2026-08-30 17:14:40 +08:00
docs: update kilo for slack part with gitlab
This commit is contained in:
Dennis Meister
@@ -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:
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user