Skip to content
K

Settings

Settings is a mode, not a page. Toggling the Settings cell in the title bar (or pressing ⌘,) swaps the stage’s occupant for the settings takeover — the roster and doors bar stay live around it, and toggling again returns you to whatever was on stage. Nothing opens in a dialog.

The takeover is a 196px section rail on the left and the active section’s body on the right. Rows use a small, fixed control set — toggle, select, tag, button — and changes apply in place; there is no save button.

The rail lists nineteen sections in a fixed order. Models comes first because it governs what can run at all; Worktrees second because it governs how work lands; Permissions third because, with several agents running unattended, it is the highest-stakes screen in the product.

SectionWhat it governs
ModelsWhich models the roster may run. Choosing one for a session happens in the command bar.
WorktreesHow an agent’s work lands — isolated checkouts and where they merge back.
PermissionsWhat an unattended agent may do outside its own worktree.
ProjectThis project’s own state — artifact publishing and removal.
PluginsFirst-party integrations, one-time imports, and the registry.
TeamSeats, the invite code, and who is here right now.
AccountThe signed-in account and its plan.
IntegrationsPer-plugin settings for plugins that registered one — GitHub, Slack, and the registry live in Plugins.
KeyboardGlobal shortcuts — bindings are read-only for now. See Keyboard Shortcuts.
TerminalWhich terminal app opens, and how session output reads.
ContextWhat gets injected into Claude Code sessions.
GeneralApplication behavior and the first-run walkthrough.
CLAUDE.mdThe behavioral contract Claude reads in every session.
Git sharingCloud team visibility for this project, plus the legacy git-mirror toggle.
AgentsSpecialist subagents Claude can delegate work to — bundled, project, and personal.
SkillsInstalled skills and the catalog of skills you can add.
MCPPer-project MCP servers — enable, disable, and add new ones.
GuideWorkflow overview and the command reference.
What’s newLatest releases and changes.

A few worth calling out:

  • Permissions is where you decide what an unattended agent may touch beyond its own isolated checkout — read it before running agents overnight.
  • Git sharing: cloud team visibility is the standard sharing lane for .mm/ data. A legacy git-mirror toggle exists and defaults to off.
  • Plugins vs. Integrations: Plugins is where things get installed and connected; Integrations holds the per-plugin settings schemas for plugins that registered one.
  • Account is where sign-in lives — and it is optional. Signed out, the app runs fully local (“Local only — team sharing off”).

Flows that need more room than a row open as subviews inside the takeover body, never as dialogs: license entry, the upgrade flow, the account switcher, managing the artifact store, the skill catalog, and editing an agent. The one modal in the app is the confirmation for removing a project.