Reference

Settings and look

Settings holds how Magnum looks and behaves, what your agents' new sessions start with, and, while a project is open, that project's permissions, servers, connectors, plugins and skills.

Opening Settings

Press ⌘,, or choose Settings in ⌘P. On a Mac it's also Settings… in the Magnum menu. Settings opens in a window of its own. Its pages come in three groups: Magnum (General, Appearance), Agents (Claude Code, Providers, Pi, Magnum Router), and the open project's: Permissions, Hooks, MCP servers, Connectors, Plugins, Skills, Agents & commands, What Magnum learned. Type in Search settings to narrow the list; Return opens the first page found.

General

Version shows Magnum's version, with "beta" after it while Magnum is in beta, and Check for updates (What's new, then Restart, once there's an update). Notify me sends banners for what Currents tells you, while Magnum is in the background or closed. Browsers and devices has two switches, both on at first: Open pages as they start (a local address printed in a terminal or by an agent's commands opens in a browser tab) and Open devices as they start (a simulator or emulator started outside Magnum opens in a device tab); see The window. Help opens this guide and the tour, and has Tips: one tip at the bottom of the sidebar when Magnum starts, at most one a day. ⌘P has Show a tip, and turns tips off or on. Share anonymous usage is explained in Privacy.

Updates

Magnum checks for an update as it starts and every four hours while it runs. A check that gets no answer, offline or with GitHub refusing for a while, is tried again after a minute, then 5 and 15 minutes, then every hour until one gets through. When Check for updates fails, General says why. When there's a new version, a notification says so once, and Update shows at the bottom of the sidebar. Either opens what's new: the notes of every release since yours. Update there downloads it, showing its progress, checks its signature against the key built into Magnum, and gets it ready; Restart puts it in place and starts it. Your agents keep running meanwhile, and Magnum picks them up again. Later leaves it ready, and it goes in when Magnum quits. Check for updates in General, Check for Updates… in the Magnum menu, and ⌘P look again, or open the update once there is one. Updates install only in the packaged app, not in a build from source.

Theme

Appearance shows a card for each theme: Light, and three dark ones, Ink, Dusk and Sage. Click one to use it.

Match the system, on at first, follows the system's appearance: Light when it's light, your dark theme when it's dark (Sage until you pick another). Picking a dark theme makes it the one used when the system is dark. Picking a theme that doesn't fit the system's current appearance turns Match the system off.

On a Mac whose macOS has it, Liquid Glass floats the sidebar in the system's glass material. It's on until you turn it off.

Density and font

Density sets how much of a session fits on screen: Comfortable, Compact or Dense. ⇧⌘L steps through them, and ⌘P has each.

Font picks one font for text, code and terminals: System (the default), Commit Mono, IBM Plex Mono or Monaspace Neon. System is the system's own font (SF Pro on a Mac, the desktop's on Linux), with code and terminals in Commit Mono. Magnum carries the others, so every machine has them. The sidebar is always set in the system's own font.

Agents

Accounts lists everything your agents sign in to, and the keys you hold: Claude accounts with their plans and limits, Codex's ChatGPT account, Pi's and OpenCode's sign-ins, API keys for running Claude Code on other models (and Codex's OpenAI key), and this Mac's sign-in for your other machines. Add account adds any of them: see Agents and models.

Then a page for each agent, laid out alike: Claude Code, Codex, Pi and OpenCode. Each shows where the agent is and its version, then what its new sessions start with: Model, its mode, and Effort where it has one (Thinking for Pi). You can change each in a session's message box. Claude Code's page also has Model aliases, which set what opus, sonnet and haiku mean to Claude Code everywhere, the terminal included; leave them empty for Claude Code's own. Pi's also shows the providers its models.json adds.

Magnum Router, under Magnum with General and Appearance, sets what it does when its rules can't tell: see Magnum Router.

The open project

These pages are for the project that was open when you opened Settings. A new rule or server asks where to save it: This project, only you; This project, shared; or All projects.

Permissions has Sandbox commands, which runs Claude Code's commands in the system's sandbox so they can't write outside the project, and the Allow, Ask and Deny rules for its tools. Always allow in a session adds a rule here.

Hooks lists Claude Code's hooks, the commands, requests and prompts it runs at points in a session (before a tool runs, when a turn stops, as a session starts), by where they're saved: This project, only you; This project, shared; All projects; each plugin's; and the machine's managed policy. Each shows its event, what it matches (a tool's name, say) and what it runs. Click one for its details, with Edit… and Remove… for those in your settings files; right-click for the same and to copy what it runs. Add hook takes the event, what it matches (where the event has one), a command, URL or prompt, a timeout, and where to save it. Run hooks turns them off for this project, only you; managed hooks still run. Hooks are Claude Code's: without it installed, the page isn't listed.

MCP servers lists the servers sessions connect to, by where they come from: Claude Code (yours), Plugins, then Pi's. The dot on each server's mark says how it stands: green connected, amber waiting on you, red failed. Click a server for its details: why it isn't connected, where it's saved, what it runs and with which variables or headers (hidden until Show values), and Remove… for yours; right-click for the same, and Turn off in this project (a server off there stays listed, Off in this project, with Turn on). A server that needs you to sign in has Sign in, which opens its page in your browser; once you're through, every session has it. Add server takes a name and a command or URL, with its environment (a command) or headers (a URL), and where to save it. The search over the page narrows the servers and searches the MCP Registry: type a service's name (PostHog, Notion, Linear) and its own server comes first. Add… asks for what that server needs, an API key say, and which way to run it when there's more than one: its URL, or a package (npm, PyPI or Docker) run on this computer.

Connectors lists your claude.ai connectors: Connected, Not connected, and Off in this project. Each has a switch for whether this project's sessions use it, as /mcp turns one off. Connect on one not connected opens claude.ai, where connectors connect; Browse opens claude.ai's connectors to add more. Click a connector for its details; right-click for the same.

Plugins lists Claude Code's plugins, each switched on or off, with Remove… in its menu, and the marketplaces' plugins to Install.

Skills lists every skill sessions can use, as Claude Code's /skills lists them: this project's, yours, claude.ai's, plugins' and those built in, then Pi's. Each says how Claude sees it in this project: On (listed with its description, which costs the tokens shown), Name only, Slash command only (Claude doesn't see it; you run it as /name), or Off. A change is saved for this project, only you (.claude/settings.local.json). A plugin's skills follow the plugin, and a skill whose own file keeps it from Claude stays so: a lock says why. Click one of the project's or yours to open its file.

Agents & commands lists the agents and slash commands sessions can use, and Pi's prompt templates and packages. Click one to open its file. New agent makes one, and Start a session runs an agent in a session of its own.

What Magnum learned lists the rules Magnum drew from your calls in this project: what you allowed and denied, how you answered, what you sent back, landed and shipped. After ten new calls of yours here, at most once a day, Claude Code's Haiku draws them again from the last 30 days; the calls behind each rule show under it. Edit one and press Return to keep it as yours (drawing again leaves it as you wrote it), clear it or click Remove to drop it (it isn't drawn again), or add one of your own at the bottom. The project's Balanced leads get them in their briefing. They're kept on this computer, in Magnum's folder, not in the repository.

Permissions, MCP servers, Connectors and Plugins are Claude Code's: without it installed, they say so.