Repositories

Connect your Git repositories to AgentsMesh for seamless AI-powered development workflows.

Overview

Repositories link your Git projects to the platform. When a Pod is created with a linked repository, the Runner automatically clones the project and sets up an isolated Git worktree.

Supported Git Providers

GitHub

Connect via OAuth for seamless authorization. Supports public and private repositories.

GitLab

Connect via Personal Access Token (PAT). Supports self-hosted GitLab instances.

Gitee

Connect via Personal Access Token. Popular in the Chinese developer community.

Authentication Methods

OAuth

For GitHub — one-click authorization with fine-grained repository access. Tokens are encrypted and stored securely.

Personal Access Token (PAT)

For GitLab and Gitee — generate a token from your provider settings and add it in AgentsMesh. Requires repo read/write scope.

Repository & Pod Association

When creating a Pod with a repository:

  1. The Runner clones the repository (if not already cached)
  2. A new Git worktree is created for the Pod
  3. The AI agent starts in the worktree directory
  4. Changes are isolated from other Pods working on the same repo
  5. When the Pod terminates, the worktree is cleaned up

Git Worktree Isolation

Git worktrees allow multiple Pods to work on the same repository simultaneously. Each Pod operates on its own branch without affecting others. This is critical for parallel AI agent development where multiple agents may modify the same codebase.

Managing Repositories

Adding a Repository

Go to Settings → Repositories → Add Repository. Select your Git provider, authenticate, and choose the repositories to connect.

Removing a Repository

Removing a repository disconnects it from AgentsMesh. Existing Pods using this repository will not be affected, but new Pods cannot be created with it.