Skip to main content

Repositories & Integrations

Connecting your source repositories lets the Coder and Tester agents work against real code instead of a task description alone. Manage repository integrations from the sidebar: Settings > Repositories.

Supported providers​

Caesell supports the following repository integration types:

  • Git — any generic git remote, authenticated manually
  • GitHub — connected via GitHub login, with repositories and branches picked from a dropdown
  • Bitbucket and GitLab — coming soon

Click + New to create an integration, pick a Type, and follow the steps below for that provider. Each integration can hold multiple repositories.

Setting up a Git integration​

Use the Git type for any host that doesn't yet have a dedicated integration (a self-hosted server, or a provider Caesell doesn't connect to directly yet).

  1. Choose an authentication method — only one is needed:
    • SSH Private Key — paste the private key that can read the repository.
    • Username and Password — HTTP Basic Auth credentials.
  2. Add one or more repositories. For each one, provide:
    • Origin — the repository's clone URL (e.g. git@host:org/repo.git).
    • Base Branch — the branch agents should treat as the source of truth (what the Coder branches from, and what it targets for review).
  3. Save the integration.

When you edit an existing Git integration later, your stored credential is shown masked. If you leave it untouched, your existing credential is kept — you only need to re-enter it if you're actually changing it.

Setting up a GitHub integration​

GitHub integrations connect through GitHub's own login instead of a manually entered credential.

  1. Choose GitHub as the type and click Connect GitHub.
  2. You'll be redirected to GitHub to authorize Caesell to read your repositories. Approve the request.
  3. You're returned to Caesell with the integration now connected.
  4. Add repositories by picking them from the Repository dropdown — it lists every repository your GitHub account can access — then pick a Base Branch from the dropdown that follows. Click + to add the pair to the integration.

Unlike Git, there's nothing to type by hand for GitHub: once connected, both the repository and its branches come from live dropdowns instead of free-text fields.

If your GitHub connection is later revoked or expires, reopen the integration and click Connect GitHub again to reconnect — your existing repository list is kept.

Managing an integration​

Click any integration in the list to view its details, or to Edit or Delete it. Once a repository is added to an integration — Git or GitHub — it becomes available to select whenever you assign the Coder or Tester agent to a task.