Majors
A long chat with a supervisor that runs a crew of threads and asks you only what needs you
A major is a supervisor you talk to. Give it a goal and it splits the work into threads, starts them, watches them and brings you only the decisions that need a person. Its threads are its crew; a thread belongs to at most one crew.
Majors are named after the major workers of an ant colony, the big-headed ants that guard and organize the nest.
Create a major
New major asks for two things:
- Name: what it's for, such as "Billing".
- What should it do: its first instruction, in your own words.
The portrait starts as a random ant on a random background colour; click it to choose another. Projects, where its threads run, its model and who it's shared with are small pickers with defaults. Create major opens it, and it starts on what you asked.
The major's screen
The major's chat sits on one side and the Crew pane on the other. Like a thread's work pane, it can be resized, swapped to the other side or maximised.
The Crew tab lists its threads by what they need:
| Group | What it shows |
|---|---|
| Needs you | What each thread is asking |
| Working | The step each thread is on |
| Ready to review | Lines changed and age, with Review |
| Up next | Planned threads, in the order they start when a slot frees up. Drag to reorder, edit or delete |
| Done this week | Merged or archived threads, with their pull requests |
Rules holds what it allows on its own and what it always asks you about. Notes is its plan, which it keeps up to date; Edit lets you change it.
It asks you itself
When a crew thread needs you, the major explains in its own chat what the thread wants, what it checked and what it recommends, with Allow, Don't allow and Open thread. You can answer in the thread instead; answering in one place clears the other. A question a crew thread asks reaches the major too, which can answer it from what it knows or pass it on to you.
Updates from its crew show in its chat as one quiet block per batch, each line linking to its thread.
Rules
A major's rules apply to its crew threads only. Two kinds:
- Allows on its own: kinds of actions or commands it may approve without you.
- Always asks you: things it must bring to you, even where your own limits would allow them.
Write rules in your own words, in the Rules tab or in the chat ("From now on, write the changelog for every release"). A rule it took from a message shows as a line under its answer. The tab also logs what the major allowed and by which rule.
A major can be stricter than you, never looser: anything your limits in Settings → Agents ask about still comes to you. For a request its rules don't cover, the major judges it with the same AI reviewer as Auto, with its rules in mind. The full order is in Approvals and Auto.
Settings
The gear in the major's header opens its settings: portrait and name, projects, where its new threads run, its model and how many crew threads work at once. Every change saves at once, and ⌘Z undoes it. With a team, Share with shares it.
Talking about other threads
Majors read thread codes. "Look at SHOP-14" works for any of your threads, not only its crew.