Add a repository to cambium
The repository needs graft set up and the App installed on it: see Set up graft on a repository.
-
Create the queue labels on it:
Terminal window oakgreen setup --repo owner/nameRun it from a clone of that repository to also get the label guide
docs/agents/triage-labels.md. Commit it. -
Add an entry to
reposin~/.cambium/config.json:{ "slug": "owner/name", "path": "~/src/name", "baseBranch": "main" }pathis a local clone; worktrees are added from it.If the repository has no CI check named
ciyet, add"requiredCheck": null. Otherwise its base never reads green and the red-base gate never clears. If the check has another name, give that name. -
Add
.claude/worktreesto the repository’s.gitignore. -
Save the file. The daemon re-reads it before every tick;
reposchanges need no restart. -
Check on the next tick:
Terminal window cambium statusoakgreen doctor --repo owner/name
Change how worktrees are prepared
Section titled “Change how worktrees are prepared”Workers get a fresh worktree per issue. What runs in it comes from a "cambium" key in the target repository’s root package.json:
"cambium": { "install": "pnpm install --frozen-lockfile", "hydrate": { "dirs": [".env.d"], "files": [".env"] }, "prepare": ["pnpm build:deps"]}installruns when the lockfile changed since the last install. Set"install": falseto skip it.hydratecopies git-ignored files and directories from the clone into the worktree.preparecommands run in order, after both.
This key decides which commands run on your machine. Protect package.json in CODEOWNERS.
Change capacity
Section titled “Change capacity”| To | Set |
|---|---|
| run more workers at once | phases.task.cap |
| give a worker longer | phases.task.wallClockMinutes |
allow more attempts before q:human |
phases.task.maxAttempts |
| change scheduling order | priorityLabels |
All keys and defaults: cambium configuration.