> ## Documentation Index
> Fetch the complete documentation index at: https://ai-development-environment.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Managed projects

> Select the GitLab projects AIDE can poll, link to worktrees, and configure with webhooks.

Open **Settings → Integrations → GitLab** to manage projects visible to the configured token.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/ai-development-environment/XmuMCFv09SOCZYoa/images/light/gitlab-settings.png?fit=max&auto=format&n=XmuMCFv09SOCZYoa&q=85&s=941eb46e75dda8829d7b84497b2866bd" alt="Managed GitLab projects in Settings in light theme" width="3840" height="2160" data-path="images/light/gitlab-settings.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ai-development-environment/aldo79nFpNgOg3HT/images/dark/gitlab-settings.png?fit=max&auto=format&n=aldo79nFpNgOg3HT&q=85&s=8540d1c397247bdf8c3fe703fa20ee4a" alt="Managed GitLab projects in Settings in dark theme" width="3840" height="2160" data-path="images/dark/gitlab-settings.png" />
</Frame>

AIDE stores GitLab's numeric project ID as the canonical remote identifier. A project's path and web URL are display and link metadata, so a namespace rename does not create a second project record.

## Add a project

Search or enter a visible project, then click **Add**. Personal, project, and group tokens can all be used. The candidate list reflects only resources the token may access.

For each project, AIDE shows:

* Namespace path and default branch
* Visibility and enabled state
* Webhook state and last delivery
* Any permission or cleanup error

## Permissions

AIDE can automatically create or update the project hook when the token has Maintainer or Owner access. With a lower role, the project remains usable and its hook state becomes **Manual required**. Follow the one-time instructions on the [Webhooks](/gitlab/webhooks) page.

Removing a project deletes only a hook whose ID AIDE recorded as its own. Existing hooks created by people or other applications are never removed.