Install the stack
You need macOS (the services are launchd agents), Node 22.13 or newer, and admin rights on the GitHub repository agents will work in.
With the setup wizard
Section titled “With the setup wizard”The oakgreen plugin asks which components you want, runs each step after you agree, and stops when oakgreen doctor passes for them.
-
In Claude Code:
Terminal window claude plugin marketplace add oakgreencc/monorepoclaude plugin install oakgreen@oakgreencc -
From a clone of your repository, ask for “set up oakgreen for my repo”, or run
/oakgreen:oakgreen-setup. -
Do the steps it hands you (creating the GitHub App, writing secrets). It checks each one before moving on.
In Kiro: Powers → Add Custom Power → Import power from a repository URL → https://github.com/oakgreencc/monorepo/tree/main/packages/plugin.
By hand
Section titled “By hand”-
Install the CLI. It brings every tool with it:
Terminal window npm install -g oakgreenInstall globally, not through
npx: the launchd agents point at the installed paths. -
Install Claude Code and sign in once (
claude), if cambium will run workers. -
Set up graft on the repository: Set up graft on a repository. Note the App slug
graft doctorprints. -
From the clone, preview, then run the bootstrap:
Terminal window oakgreen setup --dry-run --repo owner/nameoakgreen setup --repo owner/nameIt writes a cambium config skeleton at
~/.cambium/config.jsonif none exists, creates the queue labels, and writes the label guidedocs/agents/triage-labels.mdplus a pointer inCLAUDE.mdorAGENTS.md. Commit those two files yourself. -
In
~/.cambium/config.json, setgraft.appto the App slug,graft.botLoginto<slug>[bot]andworker.graftAppto the slug workers act as (often the same). -
Make sure the repository’s
.gitignorecontains.claude/worktrees. -
Start the services:
Terminal window oakgreen start -
Check:
Terminal window oakgreen doctorEvery failing line names its fix. Right after a start,
cambium heartbeatfails until the first tick finishes (30 s by default).
- Add a repository to cambium for more repositories or non-default settings.
- Connect intake sources and Set up tracing are optional.
- oakgreen CLI reference lists every doctor check.