Many agents

The Board

The Board shows what your agents are doing and did, across your projects and machines, in two views: Now, every lead, worker and session in a sentence with what you can do, and everything that needs you in one queue; and History, the same on a time axis.

Showing it

Click the Board button (a frame) in the toolbar, also with no project open: the Board opens beside your session, in the side pane on the right (below). For the whole Board in the middle, press ⇧⌘B, right-click the Board button → Full Board, choose View → Board, or press ⌘P and choose Show board; the same again brings the list back. The sidebar steps aside while the full Board shows.

Beside your session

The Board button, ⌥⌘B, View → Board Beside or ⌘P → Board beside opens Board › Now in the side pane, on the right, while your session stays in the middle; also with no project open. Opening a row's session shows it in the middle, where you are, and the Board stays beside it. Click into it for its keys (↓, ↑, ↩, ⌘↩, Space): until then they're your session's. ⇧⌘B swaps it for the whole Board in the middle; the Board button or ⌥⌘B again, or the pane's ✕, closes it. It's there again after a restart.

What needs you

What needs you is the Board too: the Board button's number counts it, as does the Dock icon's badge on a Mac. The button opens Board › Now beside your session; so do ⇧⌘I (View → What Needs You) and What needs you in ⌘P, in any project and on any machine. Agents on every machine tell you through it, so you don't go looking.

Now

Now and History at the top switch views; Hour, Today and Week set how far back both look.

Now lists every row under what it needs:

• Needs you: one queue of everything that waits on you, on every machine, in three parts with a thin line between them, the longest wait first in each:
  • What stops work: a tool approval (Allow, Deny), a question (Answer), a plan (Review plan), signing in (Sign in), a worker that stopped for you (Open, Dismiss: Dismiss leaves it stopped, its branch kept), a session waiting with no window open, on any machine (Open, Archive).
  • What's done and waits to ship: a lead's work put to you for review (Ship, Correct…, Not now), Ship's Ready to push (Push, Cancel).
  • Ideas and news: a lead's idea beyond your task (Go ahead, Not now), news on a pull request that wants you (Open, Archive), a machine that lost its connection (Reconnect, Archive).
• Running: what works now, or goes on by itself (a wakeup it scheduled, its own subagents), or asks its lead, gets ready, checks its branch, lands or waits to try again; a plan's piece waiting for others. Stop stops a session's turn, or a worker (its branch stays for review).
• Done: what finished in the range, the latest first: landed (with its time and commit), finished but not landed (Land), stopped, a session's last turn; how a Ship went, a session that finished or failed with no window open, a pull request's other news (Open).

Each row names its project, agent, model and machine. Under what it's doing, a second line says what needs a look: a budget passed, work done twice, its machine gone; or, on a worker, that its lead answered its latest ask ("Allowed by its lead"). At its right, a strip shows its turns over the range: green working, amber waiting on you.

A review shows under its row what the lead says it did, what would ship (its commits, files and lines not on its branch's upstream), the repository's check as Magnum ran it again on the lead's branch, and the pictures and clips the lead gave; click one to open it. Ship starts Ship for that project, Proceed included, and the review leaves the queue once it proceeds (where Ship can't start, it says why and the review stays); the push still waits for you. Correct… takes a line you type, which goes to the lead as your message; the review leaves the queue until the lead puts it to you again. See Balanced.

History

History draws the same rows on one time axis, Now near its right edge, with what's due right of it, for when you want to know when something happened or why it took so long.

• In Hour and Today, stretches where nothing happened fold to a narrow band marked with how long they were, so a burst of work stays readable.
• The counts beside them (wait on you, working, going on by itself, landed, in a retry) show only those rows when clicked; click again for all.
• Rows go by lead: the lead's own turns, then each of its workers, then a plan's pieces still waiting for others. Sessions with no lead go by project. A group with something waiting on you comes first, then one at work, then the latest.
• A green bar is a turn. An amber bar is waiting on you: a tool approval, a question, a plan, signing in, a budget reached. A grey bar is a worker getting ready, a blue one Magnum checking its branch, an outlined blue one its branch landing (brought from its machine first). A dashed green bar ending in a ring at Now is a session whose turn is over but whose agent goes on by itself: a wakeup it scheduled, or its own subagents. A dashed grey bar is a worker waiting to try again. Hover a bar for its times, its model and what it cost.
• A white tick is a commit on a worker's branch, a green dot its landing, an amber ring a landing that didn't go through, a grey square its stop, a red tick an attempt that failed. On a lead's row, a white dot is a message you sent it.
• Next, right of Now: what's due, at its time: a wakeup, a retry after its pause. A dashed bar across it is a piece that starts once the pieces before it land.
• A grey line between two workers is a plan's order: it runs from a piece to the one that began once it landed, ending in a dot there. A red line joins an attempt that failed to its next.
• Still open from earlier: what has waited on you since before the range begins, from where the axis starts.
• Spent: what each turn cost as it ended.

Watch

Above History's axis, the Board points at what's going wrong or about to, the worst first, with what to do:

• An attempt that kept working after Magnum started its next one (the same piece done twice): Stop while it still works, else Open.
• A worker whose machine isn't connected while its attempt is under way.
• A worker that has used most of its budget (four fifths) with work still to come: its turn may stop short.
• A worker that spent more than half again its budget.
• A worker at work 15 minutes or more, or that spent a dollar or more, with nothing committed yet.
• Something that has waited on you for an hour or more (one from before Magnum's record began: still waiting, since when isn't known).

Its row carries a dot, and the stretch at issue is outlined on its bars. Click a line to choose its row.

Focus

In History, Focus, by a lead's name, shows that lead alone, with each of its plans drawn as a map above the time axis: a stop for each piece, in the column after the pieces it needs, joined from them, and Ship at the end with the commits not pushed yet. All brings the rest back. Now always lists everyone's.

Acting

At Now, each row has what you can do there:

• Allow answers a tool approval; Deny asks why first (the agent is told; leave it empty for a plain no). Answer, Review plan or Sign in opens what a session waits on.
• Ship, Correct… and Not now for a review; Go ahead and Not now for an idea; Push and Cancel for Ship's Ready to push.
• Stop stops a session's turn, or a worker (its branch stays for review).
• Land lands a worker that finished without landing on its own.
• Open and Dismiss for a worker that waits on you: Dismiss leaves it, stopped, its branch kept.

Click a row, or its Open, to open its session: the Board gives way to it, as a tab or, with tiles on, a tile (a session that isn't open opens first). See Sessions for tabs and tiles.

With the Board focused, ↓ and ↑ (or Tab and ⇧Tab) choose a row, ↩ opens its session (a tab, or with tiles on, a tile), and Esc clears the choice, then, in History, the count you clicked, then Focus.

In Needs you, ⌘↩ does the chosen row's first button (Allow, Ship, Push, Go ahead) and ⌘⌫ its other (Deny, Not now, Dismiss, Cancel); the chosen row's buttons show them. Space marks the chosen row: with rows marked, a bar counts them and their buttons ("Allow 4"), and ⌘↩ or ⌘⌫ does each marked row's at once (not Open, Correct… or Stop). Esc clears the marks.

Right-click a row that each machine's node keeps (a session's wait, Ready to push, a pull request's news, a machine): Remind me later brings it back in 30 minutes, 1 or 2 hours, or tomorrow at 9:00; Archive puts it away until something new happens; Mute session keeps a session's out of notifications and counts. A session that still waits stays listed: put off, under Running, marked Later or Archived (one with no window open here goes back to where its last turn left it); muted, under Needs you, marked Muted and not counted (Unmute session brings it back).

Going where a row leads

Its buttons go where a row leads: its session (attached to its agent if that still runs), the pull request, or the machine, which Magnum tries to connect again. A need goes once you answer it in its session.

Press ⌥⌘↓ for the next session in the sidebar that waits on you, in any project.

Later, archived, muted

Right-click a row. Remind me later brings it back in 30 minutes, 1 or 2 hours, or tomorrow at 9:00. Archive puts it away until something new happens. Mute session keeps a session's out of notifications and counts: its rows stay listed, marked Muted, and Unmute session brings them back.

Other machines

Each machine's node keeps its own Currents, so what an agent there needed while Magnum was closed waits for you. Magnum gathers every machine's into the Board's queue, where a row from another machine names it beside its project. What you do to a row reaches the machine that holds it.

Notifications

While Magnum is in the background, it notifies you when a session finishes, fails or waits on you, and of news from elsewhere: a pull request, a machine that can't reconnect, a reminder come due, an agent on another machine. Clicking one goes there, the Board giving way to a session. Notify me, in Settings → General, turns these off, and those Magnum Helper (Magnum's node on Linux) sends while Magnum is closed.

With Magnum closed

On a Mac, your agents here run in Magnum Helper, which stays after you quit while they work. Its menu bar item lists what needs you, the agents here, and those on your machines; choosing one opens it in Magnum, the Board giving way to it. It also has Stop All Agents. Magnum Helper notifies you of what newly needs you here once macOS allows it; if you turned that down, Board › Now offers Open Notification Settings.

On Linux, Magnum's node does the same with a tray icon, on desktops that have a tray (KDE, GNOME with the AppIndicator extension, and others), and the desktop's notifications. Clicking the icon opens Magnum; the other button shows the menu.

What it reads

Magnum keeps a record of what it sees, each session's turns and waits and each worker's stages, on this computer for 30 days (~/.magnum/trace). Turns from before the record began are read from Claude Code's session files on this computer. A worker on another machine shows what Magnum saw of it; its commits are read there while the machine is connected.