Skip to content
baum
welcome to the docs

Hi, I’m Stumpy. Looking for something?

Search the docs, or start with the basics.

Make it yours.

Everything you can change in baum's Settings, the Repositories page and the tray menu.

Open Settings from the sidebar. It has five tabs.

Setting What it does
Preferred theme Light, dark or follow your system.
Page shortcut modifier The key you hold with 1 to 8 to open the sidebar’s pages.
Plan usage Which Claude and Codex plans baum shows in the sidebar and tray. By default, the ones baum uses, but you can turn on any other plan on your computer, such as Codex while baum reviews with Claude Code. See Usage.
Setting What it does
Review pull requests automatically Reviews new pushes and review requests on their own. Drafts, forks and authors without write access are skipped.
Which pull requests Only mine, only the ones I’m asked to review, both, or every open pull request.
Agent that writes reviews Claude Code or Codex.
Model A preset, or the name of any model your agent accepts.
Review reasoning effort How hard the agent thinks. Default leaves it to the agent.

The same tab holds Data extraction, the job that pulls decisions out of your sessions and groups pull requests into features:

Setting What it does
Extract decisions and features Turns extraction on or off.
Agent that extracts Claude Code or Codex. Follows the review agent unless you choose another.
Model and effort Usually a smaller model than for reviews.

See Reviews for how reviews are generated.

Setting What it does
Agent that fixes The agent that fixes conflicts, failing checks and review comments when you ask. Same as reviews by default.
Model and fix reasoning effort As for reviews.
Setting What it does
GitHub Connect or disconnect your GitHub account.
Agent hooks Connect, update or remove the baum plugin in Claude Code and Codex. Codex also needs you to approve its hooks with /hooks. See Sessions.
Setting What it does
Check this computer Finds problems with GitHub, your agents, the hooks and the baum command, and tells you how to fix them.
Jobs at once How many reviews, fixes and feature builds run in parallel. Lower it if they slow your computer down.
Review time limit How long a review may run before it stops. 10 minutes by default.
Fix time limit How long a fix, a question to a review’s agent or a feature build may run. 30 minutes by default.
Command line Install or remove the baum command that the agent plugin runs.
Zoom Make everything in the window larger or smaller.
Environment for agents Extra environment variables for the agents baum runs, and for the commit and push after a fix. Stored on your computer, so don’t put secrets here.
Answering agents Answer Codex approvals from the app. While it’s on, Codex waits up to 25 seconds for your answer in baum before it shows its own prompt.

On the Repositories page, each repository has its own settings:

  • Automatic reviews: turn them off for one repository while they stay on for the rest.
  • Clone: the folder baum uses for that repository, or Clone it if you don’t have one yet.
  • Remove registration: stop following the repository.
  • Pause automatic reviews: stops every automatic review at once, in every repository, until you resume them. Queued reviews are cancelled and running ones finish.
  • Start at login: open baum when you log in.
  • Notifications: choose which events notify you.
  • Quit and stop background reviews: quit the app and stop baum’s background service.