Documentation

Everything in MControl, one feature at a time. Short and simple.

The flow

From an idea to merged code. MControl moves each step forward, and the board follows by itself.

  1. 01

    Write it down

    Add a task, import it from Jira or Linear, or just type it into Spotlight.

  2. 02

    Start a run

    Pick an agent. It works on its own branch in its own folder, with your team's Playbook.

  3. 03

    Follow along

    Watch every step live, answer questions, send follow-ups or stop it.

  4. 04

    Open a pull request

    One click commits, pushes and opens it with the agent's summary. Or let it happen automatically.

  5. 05

    Review

    Let an agent review it, and ask your team in MControl to take a look.

  6. 06

    Merge and done

    The task moves to Done and the run's summary stays on it for everyone.

What's possible

Several agents at once

Run Claude Code, Codex and Grok Build side by side, each on its own branch.

One Playbook for all

The same instructions and guardrails for every agent and every teammate.

A board that moves itself

Runs, pull requests and merges move tasks without anyone dragging cards.

Local AI on your Mac

Tidy prompts, combine tasks, group repositories and write standups, offline.

Live team status

See who works on what and which agents run, end-to-end encrypted.

Your day at a glance

Work time and tokens in the title bar, failures and reviews first in Mission Control.

Getting started

MControl runs Claude Code, Codex and Grok Build for you, each in its own copy of the repository.

Download
Get the app from mcontrol.tech, open the DMG and drag MControl into Applications. It needs macOS 26.
Agents
Install at least one agent: Claude Code, Codex or Grok Build. MControl shows the install command when one is missing.
Repositories
MControl finds the git repositories on your Mac. In Settings → Repositories you choose which ones it uses.
First run
Press New Run, write what the agent should do, pick a repository and start. That's it.

Mission Control

Team

  • Maya

    Available

    Rate-limit headers for the public API

    acme/api · agent/rate-limit-headers

    Codex12m

  • Jonas

    Deep Work

    Banner when the app is offline

    acme/ios · agent/offline-banner

    Grok Build3m

  • Lea

    Available

    Filters for search results

    acme/web · lea/search-filters

    Claude Code21min terminal

  • Diego

    In a Meeting

    Shares only their status

Running agents

Standup

Yesterday the team merged 2 pull requests, passkey sign-in among them. Right now 4 agents are running: payment retries, rate-limit headers, the offline banner and search filters. 2 pull requests wait for your review, and #211 already has green CI.

Local AI · this morning

Your queue

Activity

  • Jonas started Grok Build on “Banner when the app is offline”3m ago
  • You started Claude Code on “Retry failed payments in checkout”6m ago
  • Maya started Codex on “Rate-limit headers for the public API”12m ago
  • Maya approved #21018m ago
  • Diego opened pull request #21125m ago
4 running5 online2 reviews
Live replica of the app. Click around.

Spotlight

The search field in the middle of the title bar. It finds and starts everything.

Search⌘K
Type to find tasks, agent runs, pull requests, team prompts, repositories and commands.
Complete⇥
While you type, the rest of the best match shows in grey. Tab or → takes it.
Open↵
Return opens the highlighted result. The arrow keys move through the list.
Ask an agent
Any text you type can go straight to your default agent as a new run.
New task
Or turn the text into a new task on the board.
Live replica of the app. Click around.

Agents and sessions

Every run works on its own branch in its own folder, so your checkout stays untouched.

New Run⌘N
Write the task, then choose the agent, its model, the mode and the repository.
Branch
Runs start from develop or main by default. The branch menu picks any other branch.
Modes
Plan reads and plans without changing files. Edit changes files and runs allowed commands. Full Auto runs everything, only in its own folder.
Improve with Local AI
Tidies up a rough prompt on your Mac, keeping every detail. Undo brings your own text back.
Sessions in the sidebar
The icon shows the kind: pull request review, plan, task or chat. Its color shows the agent. A dot means it's still running.
Rename
Click a session's title at the top of its page to give it a new name.
Branch button
Opens the branch on GitHub once it's pushed. Before that, a click copies its name.
Open Pull Request
Commits the changes, pushes the branch and opens a pull request with the agent's summary.
Run Again
Starts a failed or stopped run again with the same task, repository and agent.
More (…)
Open the folder in your editor, Terminal or Finder, copy names and paths, or discard the run.
Terminal sessions
Agents you start in a terminal or editor show up too, with the app they run in.
Compare agents

Save the cart for later

Playbook v14

Claude Code

Running

agent/save-cart-claude

Codex

Running

agent/save-cart-codex

Grok Build

Running

agent/save-cart-grok

Same task, same playbook, three worktrees. Pick the result you like.

Live replica of the app. Click around.

Tasks

The board moves by itself: a run starts → In Progress, a pull request opens → In Review, it merges → Done.

Board
Drag tasks between Backlog, Ready, In Progress, In Review and Done. Group by person if you like.
KeyboardN
Arrows move the focus, ⌥ arrows move the task, Return opens it, N adds one, ⌘⌫ deletes.
Pick several⌘-click
⌘-click tasks to pick more than one. A bar offers Combine and Delete. Esc clears the selection.
Combine with Local AI
Turns the picked tasks into one. Local AI writes the title and description from them, and you can change both before saving.
Run
In a task's panel: opens a new run with the task as the prompt.
I'm on It
Assigns the task to you and shows the team you're working on it.
Break Down with AI
Splits a task into smaller subtasks.
Run Summaries
When a run for a task finishes, its summary appears on the task for the whole team.
Jira and Linear
Connect them in Tasks to import your issues. The import only reads, and the token stays in this Mac's Keychain.

Watch: tasks move on their own.

Backlog2

  • #45

    Export orders as CSV

  • #46

    Welcome email for new accounts

Ready1

  • #43

    Show the delivery date in the cart

In Progress5

  • #41

    Retry failed payments in checkout

    Claude Code

  • #42

    Clear messages for declined cards

    Codex

  • #38

    Rate-limit headers for the public API

    Codex

  • #44

    Banner when the app is offline

    Grok Build

  • #39

    Filters for search results

    Claude Code

In Review4

  • #36

    Cache product images at the edge

    #211CI passed

  • #35

    Crash on an empty cart

    #209CI running

  • #37

    Build the search index faster

    #210CI passed

  • #33

    Dark mode for settings

    #207CI failed

Done2

  • #31

    Sign in with passkeys

  • #32

    Paginate the order history

From the GitHub CLI

Waiting for your review2

  • #211perf: Cache product images at the edge

    diego/image-cacheby Diego+88 −14CI passed

  • #209fix: Crash on an empty cart

    agent/empty-cart-crashby Jonas+12 −3CI running

Yours1

  • #210perf: Build the search index faster

    agent/search-indexby You+64 −41CI passed

Live replica of the app. Click around.

Pull requests

Open pull requests across your repositories, with checks, reviews and conflicts at a glance.

Lists
Team Asks for Review, Needs Your Review, Yours, then the rest by repository.
Agent review
Let an agent review a pull request. MControl posts the review as a comment on GitHub.
Ask for Review
⌘- or ⇧-click pull requests, then “Ask for Review”. Add a note, and your team sees it at the top of Pull Requests.
Copy Message
Copies the same request with the GitHub links, ready to paste into any chat.
After a run
In Settings → Agents you choose what happens when a run finishes with changes: ask, open a pull request or open a draft.

Waiting for your review2

  • #211perf: Cache product images at the edge

    diego/image-cacheby Diego+88 −14CI passed

  • #209fix: Crash on an empty cart

    agent/empty-cart-crashby Jonas+12 −3CI running

Yours1

  • #210perf: Build the search index faster

    agent/search-indexby You+64 −41CI passed

Team1

  • #207feat: Dark mode for settings

    lea/dark-settingsby Lea+132 −20CI failed

Live replica of the app. Click around.

Repositories

Your local repositories with status, history, worktrees and pull requests.

Groups
Related repositories (like app and backend) are grouped automatically. Regroup with Local AI, or move them yourself.
Which ones
Settings → Repositories decides which repositories MControl uses everywhere.

Playbook

Your team's instructions for agents: every run started in MControl gets them.

Documents
Instructions, output standards, review checklist and guardrails, written in Markdown.
Formats
Start from Lean, Structured or Strict. Picking one only fills your draft.
Prompts
Reusable team prompts. They also appear in Spotlight and as commands in your agents.
Guardrails
Highest mode, own folder for every run, protected branches, denied tools and a pinned model.
Publish
Leads publish changes. Members propose them.
Keep my agents aligned
Off by default. When on, the same instructions go into your agents' global files, so terminal sessions follow them too.
Check
Shows the full text agents receive, and who on the team is on which version.

Playbook

v14

System instructions

  • Read the code around a change before you edit it.
  • Keep changes small and focused on the task.

Output standards

  • Commits follow Conventional Commits.
  • Every change that can break comes with a test.

Review checklist

  • Does the change do what the task asks, and nothing else?
  • Are there tests for new behavior?

Shared prompts

  • /fix-tests Fix failing tests
  • /review Review my changes
  • /explain Explain this code

Guardrails

Highest mode
Forbidden commands
  • rm -rf
  • git push --force

Always in a worktree

Try it: change the highest mode or forbid another command.

Every run in MControl

  • claude --append-system-prompt
  • codex -c developer_instructions=…
  • grok --rules

Agents in the terminal

~/.claude/CLAUDE.md

<!-- MControl playbook v14 -->

- Commits follow Conventional Commits.

- Highest mode: Full Auto

- Forbidden commands: rm -rf, git push --force

~/.codex/AGENTS.md

<!-- MControl playbook v14 -->

- Commits follow Conventional Commits.

- Highest mode: Full Auto

- Forbidden commands: rm -rf, git push --force

Shared prompts as slash commands:/fix-tests/review/explain

Who's on which version

  • Youv14
  • Mayav14
  • Jonasv14
  • Leav131 behind
  • Diegov14
Live replica of the app. Click around.

Mission Control and the title bar

Mission Control starts with what needs you: failures, reviews and blocked work.

Customize
Show, hide and arrange the sections of Mission Control.
Work time
The clock shows how long you've used this Mac today and the tokens your agents used. Five minutes without input pause it.
Today's numbers
Click the clock for agent time, tokens in and out, and cost. You can pause it, and in a team share today's numbers.
Tools
Shows or hides the Quick Tools panel.
Menu bar
MControl's menu bar item shows your runs and status without opening the window.

Teams

A shared Playbook, board and live status for everyone. Teams need Pro on every Mac.

Create Team
Give it a name. You get an invite link to send to your teammates.
Join
Open the invite link, or paste it in Team. The link holds the key to the team's data.
MControl Cloud
Teams sync end-to-end encrypted. The server only sees random ids and encrypted data, and nobody signs in with an email.
What you share
Name, status, note, focus task and Playbook version. Repositories, agent titles, terminal sessions and work time only if you turn them on.
Not shared
Your prompts and agent chats never leave your Mac. Teammates see a run's summary on its task.
Leave Team
In Settings → Team. MControl removes your membership and forgets the team's key.

Your status

What you share

Try it: change your status or what you share.

  • You

    Available

    Retry failed payments in checkout

    acme/web · agent/checkout-retry

    Claude Code6m

  • Maya

    Available

    Rate-limit headers for the public API

    acme/api · agent/rate-limit-headers

    Codex12m

  • Jonas

    Deep Work

    Banner when the app is offline

    acme/ios · agent/offline-banner

    Grok Build3m

  • Lea

    Available

    Filters for search results

    acme/web · lea/search-filters

    Claude Code21min terminal

  • Diego

    In a Meeting

    Shares only their status

Live replica of the app. Click around.

Cloud runs and the web app

Claude Code can also run in Anthropic's cloud, from the Mac app or from the browser at app.mcontrol.tech.

Run in: Cloud
In the composer's options, choose Cloud instead of This Mac. The run starts from GitHub's copy of the base branch, works on its own branch and pushes it there. Your Mac can sleep.
Anthropic API key
Cloud runs use your own key: in the Mac app under Settings › Agents, in the browser under Settings. Runs are billed to it, tokens plus session time.
app.mcontrol.tech
Mission Control, agents, tasks, pull requests, the Playbook and your team in the browser. The same cloud runs show up in the Mac app and on the web.
Sign in with GitHub
Connects your repositories in one step. The token stays in your browser. A pasted token works too.
Spotlight⌘K
Search everything or hand text to an agent, as in the app.
AI help
Improve a prompt, write today's standup or prepare an agent brief. The browser's own on-device model is used when it has one; otherwise Claude Haiku with your key, and the page says which.
Web App (Mac settings)
Settings › General › Web App › Connect the Web App opens your space in the browser. Without a team it makes a private space for your own Mac and browsers. The web then shows your board, Playbook and the agents on your Mac under On your Mac, also terminal sessions and the last day of runs. Everything is end-to-end encrypted. Disconnect removes the space from MControl Cloud and keeps everything on your Mac.
Codex and Grok Build
They run on your Mac. Codex cloud has no public API yet.

MControl Pro

Pro adds teams, the live relay and appearance. Everything else is free.

Price
€9.99 a month or €99 a year per Mac. Teams €12.99 or €129 per Mac. Students get 40% off. Cancel anytime.
Subscribe
Open Pro in the app and choose “Subscribe to Pro”. Checkout runs at Stripe in your browser.
One key, one Mac
Your key works on one Mac at a time. “Remove from This Mac” frees it for another.
Manage Subscription
Change your payment method, see invoices or cancel. Pro stays until the paid period ends.
Restore Subscription
Lost your key? Get it back with your email and the restore code from your receipt.

Privacy and safety

MControl keeps your work on your Mac and out of shared places.

Local AI
Prompt cleanup, task briefs, combining tasks and standups run on your Mac. Nothing leaves it.
No traces
Commits, branches, pull requests and reviews don't mention MControl.
Keys
Jira, Linear and team keys stay in this Mac's Keychain, never in logs or prompts.