Skip to content

Get started

How Codebot works

Every review and every request is a run. Each run gets its own cloud sandbox with a fresh checkout of your code.

Runs

Everything Codebot does is a run: a review of a pull request, an answer to a mention, or a Linear issue it works on. Runs start from an event on your git host or a message in one of your tools:

What happensWhat Codebot does
A pull request opens, gets new commits or is marked readyReviews it, if code review is on for the repository
Someone comments @trycodebot review on a pull requestReviews it, whatever the skip rules say
Someone mentions @trycodebot with a request on a pull requestThe agent answers on the pull request, and may push a fix
An issue is assigned to Codebot in Linear, or it’s mentioned thereThe agent works on the issue and opens a pull request
Someone tags @trycodebot in a Discord channelThe agent replies in the channel

Every run shows in Activity in the web app, with its status, what triggered it and a transcript of what the agent did. See Activity and runs.

Sandboxes

Each run executes in an isolated cloud sandbox (a short-lived virtual machine). Codebot clones your repository at the exact commit it’s working on, runs the agent there, and throws the machine away afterwards. Nothing runs on your laptop or in your CI.

Agent work on a Linear issue, a pull request or a Discord conversation keeps its sandbox between messages for a while, so a follow-up continues where the last request stopped.

Models

Codebot runs on the model you choose, with your own API keys. You pick a model for code review and one for the agent; any model from a provider you added in Model providers is available.

What Codebot can do

  • Code reviews are read-only. A review reads the diff and the repository and posts findings. It doesn’t install dependencies, build, run tests or push.
  • The agent follows your rules. Admins choose on the Agent page whether it may push branches and open pull requests, and whether it may update Linear issues. Those rules apply wherever it’s mentioned.
  • Its identity is visible. On GitHub it posts as the TryCodeBot app. On Azure DevOps it posts as the user whose token you connected, and labels each comment Posted by Codebot.

Where to change things

Page in the web appWhat it controls
Code reviewRepositories that get reviewed, the reviewer model, review outcome, triggers and skip rules
AgentThe agent’s model, instructions and permissions, and the places you can mention it
Settings → IntegrationsGitHub and Azure DevOps, Linear and Discord, and services such as Vercel and Sentry
Settings → ModelsAPI keys for model providers
Settings → UsageCompute and token usage