Agent companies
Board settings
Control when agents start, whether each task gets its own worktree, and how many run at once.
The board’s settings menu controls three things.
Auto-run agents
When on, tasks start as soon as they are ready: a task in To do with an assignee, a task in Review with a reviewer, or a comment that needs a reply.
Turn it off to start tasks only with Start agent on a task. This is a good way to pause a whole company without editing anyone.
Worktree per task
When on, each top-level task gets its own git worktree on a board/<task> branch from the project’s current HEAD. Subtasks work in their parent’s worktree.
A project folder that isn’t a git repository, or a repository with no commits yet, has nothing to branch from, so agents work in the folder itself. Make a first commit to give later tasks their own worktrees.
Turn it off to let agents share the project checkout. Only do that for a company that works on one task at a time, since parallel agents in the same checkout will trip over each other.
Agents at once
How many tasks can run at the same time. Ready tasks wait for a free slot.
Replies to your comments start even when the board is at this limit, so a question never waits behind a long task.
Settings elsewhere
| Setting | Where |
|---|---|
| Company token limit, departments, workspace, company memory | Edit company in the company menu |
| Employee model, permissions, skills, token limit, memory, pause | The employee’s editor on Org chart |
| Schedules | Routines tab |