Many agents

The Factory

The Factory is a canvas of every project in the sidebar at once, each session a card, so you can watch many agents side by side: by project or by machine, a lead joined to its workers. Popups let you work in several sessions without leaving it. Beside it, Now is the one queue of everything that needs you, and History the same work on a time axis.

Showing it

Click Factory in the toolbar, press ⇧⌘B, choose View → Factory, or press ⌘P and choose Show factory; the same again brings the list back, as does ✕ at the Factory's top right. The sidebar steps aside while the Factory shows. Magnum keeps the level and arrangement you leave.

Far, Mid and Near

Change level with the Far, Mid and Near buttons, ⌘= and ⌘-, a pinch, the Factory's right-click menu or ⌘P, or double-click a card to go in. Scroll to move around; at Mid you can also drag empty space or click the map in the corner. The toolbar's title is a breadcrumb: Factory goes to Far, the project to Mid.

Arranging and finding

The bar over the Factory has three things. Project and Machine arrange it: a frame per project, or a column per machine. Needs you (waiting on you, or failed) and Working (in a turn) count those sessions, each there only while there's one: click a count and the Factory shows only those cards, gathered in their frames, the rest out of the way; click it again for all. Search sessions does the same with what you type: only the sessions whose title or project matches stay. At Far, the tiles with no match dim instead.

Drag a card to another place in its copy. Right-click a frame to Tidy up its cards or start a New session in it; Tidy up all, in the Factory's right-click menu and ⌘P, tidies every frame. While a count or a search narrows the Factory, cards are packed as they come: they keep the places you gave them for when it shows all again. Drop an open session's card on another copy of its project while it isn't working or waiting on you, and Magnum offers to continue it there (see Environments).

The side panel

At Mid, click a card to choose it, and its panel opens at the right: the session's state and where it runs; Open (in the list, the Factory giving way to it), Pop out (a popup on the Factory), Move (to another copy) and Focus (Near); its agent, model, context and last active; a worker's budget, commit and task; a lead's workers; its latest reply. Esc closes it. Drag its left edge to make it wider or narrower (280 to 640 points); the width is kept.

Leads and workers

By project, a lead's workers stand beside it, wherever they run; by machine, they stay in their machine's column. Lines join a lead to its workers, the stretch into a worker coloured while it works, needs you or has failed. A lead's card shows how many landed ("1 of 3 landed"); a worker's card shows its machine, latest commit and stage. Swarm tells how a lead starts workers.

Popups

A popup is a session itself, floating over the Factory, so you read it and answer it without leaving the Factory; several can be open at once, from any project. Press ↩ on a chosen card, or use the panel's Pop out or Near's: it opens beside its card (a session that isn't open opens first) and follows the card as the Factory moves. Pin, in its header, keeps it where it is instead.

Drag a popup by its header and resize it from its corner. Minimized, it's a pill with the session's state and what it does now, and Allow and Deny when it waits on a tool approval; click the pill to expand it. In a popup, Esc minimizes it (⌘. still stops the turn), and ⌘W or its ✕ closes it, leaving the session open in the sidebar. A popup comes back where you left it, also after Magnum restarts. ⌘P has each popup's Minimize or Expand, Pin and Close.

Popups are the Factory's: in the list a session shows as a tab or a tile (see Sessions), and its popup waits on the Factory.

The Factory's keys

With the Factory focused (click empty space), Tab, ⇧Tab and the arrow keys step through the cards in the sidebar's order. ↩ opens the chosen card's popup, or at Near puts you in its message box. Esc clears the choice. ⌘= and ⌘- change level. These keys don't act while you type in the search or a message box.

What needs you

The bell beside the Factory button counts what needs you, as does the Dock icon's badge on a Mac. Click it, press ⌥⌘B (View → Factory › Now Beside) or ⇧⌘I (View → What Needs You), or choose What needs you in ⌘P, in any project and on any machine (with no project open, by its keys or ⌘P: the toolbar has no bell there): Factory › Now opens in the side pane, on the right, while your session stays in the middle. Agents on every machine tell you through it, so you don't go looking.

Opening a row's session shows it in the middle, where you are, and Now stays beside it. Click into it for its keys (↓, ↑, ↩, ⌘↩, Space): until then they're your session's. The bell or ⌥⌘B again, or the pane's ✕, closes it; opening the Factory closes it too. It's there again after a restart.

Now

Now lists every row under what it needs:

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 Swarm.

History

⌘P → Factory: Now and History shows the two in the Factory's place: Now and History at the top switch between them, Hour, Today and Week set how far back both look, and Canvas brings the canvas back.

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.

Watch

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

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:

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

With Now or History 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.

Open on a session that isn't open here (a worker's, on its machine) connects that machine first when it isn't connected. The button turns while it does, and the row says Opening…; if it can't, the row says why under it: the machine can't be reached, its agent isn't installed there, or its session is gone. On the Factory, a card's mark turns the same way, and why it couldn't shows in a notice.

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 Factory'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 Factory 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 Factory 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, Factory › 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.