Magnum Guide

Basics

• Start hereMagnum is an agentic development environment (ADE), a desktop app for running coding agents: Claude Code, Codex and Pi. It runs on macOS and Linux, with…
• The windowMagnum's window, part by part: the toolbar along the top, the sidebar on the left, the session area in the middle (as tabs or tiles), and the side pane on…
• SessionsA session is one agent working on one task in a project. Sessions run side by side, in every project, and each says when it needs you.
• The message boxThe message box is where you talk to a session's agent: + to attach, your message, and Send. Under it are where the session runs, what it runs with (the…

Agents

• Agents and modelsMagnum runs four agents: Claude Code, Codex, Pi and OpenCode. Each keeps its own sign-in, shared with the same agent in your terminal. A session runs one…
• Magnum RouterMagnum Router picks the model and effort for each message you send in a session, among its agent's own models: a quick question goes to a fast model, a wide…
• Magnum Router in practiceWhat Magnum Router does with the messages you'd really send, in a Claude Code session with Auto chosen in the model picker: what you type, how its rules…

Machines

• EnvironmentsA session's environment is where its agent runs: this Mac, a worktree, or one of your machines. Each session has its own, so one project can have sessions…
• MachinesA machine is another computer Magnum reaches over SSH: a Linux server, a cloud VM, another Mac. Magnum installs its node there, and your agents run on it…
• One project, many machinesA project can have copies: checkouts of its repository on this Mac and on your machines, and its worktrees. Magnum shows them as one project, and each…

Many agents

• BalancedWith Balanced on, a session leads: it hands pieces of its task to workers on the machines you tick. Each worker works in a worktree and a branch of its own,…
• Balanced in practiceWhole runs with Balanced, start to finish: what you set up, what you type, what Magnum does at each step, and what's left for you to decide. The names (a…
• The chiefThe chief is one session that leads your leads: you tell it what you want across your projects, and it starts leads, keeps track of them, answers what they…
• The BoardThe 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…
• Control and UsageControl lists every run on every machine; Usage shows what your agents spent. What needs you is on The Board.

Shipping

• Changes and worktreesChanges shows what your agents changed, by session, to review, keep or undo, then commit and push. A worktree gives a session a branch and a folder of its…
• Run and ShipRun starts the project you're working on and shows it: a web app in a browser tab, a phone app on a simulator or emulator in a device tab. Ship takes your…

Automations

• AutomationsAn automation is a list of steps Magnum goes through for you: when you say so, or on a schedule, with Magnum open or closed. Each step is one of Magnum's…

Reference

• Settings and lookSettings holds how Magnum looks and behaves, what your agents' new sessions start with, and, while a project is open, that project's permissions, servers,…
• Keyboard shortcutsEvery key Magnum binds: first as Magnum's own list groups them, then tabs and tiles', the Board's and terminals' on Linux. Keys are written as on a Mac; on…
• PrivacyMagnum runs your agents on your own machines. Your code and prompts go to those machines and to the model providers your agents use. Magnum has no server of…
• TroubleshootingWhat Magnum tells you when something is wrong, and what to do about it.