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 happens | What Codebot does |
|---|---|
| A pull request opens, gets new commits or is marked ready | Reviews it, if code review is on for the repository |
Someone comments @trycodebot review on a pull request | Reviews it, whatever the skip rules say |
Someone mentions @trycodebot with a request on a pull request | The agent answers on the pull request, and may push a fix |
| An issue is assigned to Codebot in Linear, or it’s mentioned there | The agent works on the issue and opens a pull request |
Someone tags @trycodebot in a Discord channel | The 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 app | What it controls |
|---|---|
| Code review | Repositories that get reviewed, the reviewer model, review outcome, triggers and skip rules |
| Agent | The agent’s model, instructions and permissions, and the places you can mention it |
| Settings → Integrations | GitHub and Azure DevOps, Linear and Discord, and services such as Vercel and Sentry |
| Settings → Models | API keys for model providers |
| Settings → Usage | Compute and token usage |