Getting Started

Monday Morning is local-first project management for developers — it runs your agents, whoever sells the model. It stores structured project state in a .mm/ directory inside your repo, and the desktop app dispatches, watches, and records agent work against it.

Quick Start

1. Download Monday Morning — Head to getmondaymorning.com/download and grab the installer for your platform:

   Platform	Format
   macOS (Apple Silicon / Intel)	.dmg
   Windows	.msi / .exe
   Linux	.AppImage / .deb

2. Launch the app — You land directly on the Floor, Monday Morning’s one screen. There is no sign-in wall: signed out, the app runs fully local (“Local only — team sharing off”). Signing in is optional and enables cloud team visibility — you can do it later from the account cell in the title bar.

3. Connect a provider — Monday Morning dispatches agents through a harness adapter; Claude Code and OpenAI’s Codex CLI are the shipped adapters. If you don’t have either yet, install one and authenticate in a terminal:

   claude login

   Tip

   If Claude Code is already installed and authenticated, there’s nothing to do — the app detects it. Until a provider is connected, the welcome pane’s Connect a provider action is the one lit-up button, and dispatch stays dormant.

   New to Claude?

   Claude Code is Anthropic’s CLI for working with Claude. You’ll need an Anthropic account — claude login walks you through the setup.

   Prefer GPT models?

   OpenAI’s Codex CLI (@openai/codex) is the second shipped adapter — GPT/Codex models are grouped separately in the model picker and only spawnable once an OpenAI connection is authenticated. Install it with npm install -g @openai/codex, then run codex login; back in the app (setup’s provider step, or Settings → Models), click Connect via ChatGPT login and it detects the login for you — no key to paste. An OpenAI API key is the alternative if you’d rather pay per-token than use a ChatGPT plan. Either way, this is separate from any OpenAI key you’ve stored in Monday Morning for gating — that key is never handed to Codex, which always uses its own codex login session.

4. Add a project — Adding a project happens in the command bar, not a modal. Open the project menu in the title bar and choose Add project: an “Add project” chip appears and the ask line becomes a path input. Type or paste the path to any git repository. The app resolves it and either sets the project up (creating .mm/, commands, and agents), tells you it’s already initialised, or explains that the path isn’t a git repository — inline, with your typed text kept so you can edit and retry.

5. Dispatch your first agent — With an empty roster, the stage shows the welcome pane and its three actions: Add your first agent (puts a real task from the project into the ask — edit it or dispatch as-is), Connect a provider, and Open the roadmap. Or just type what you want done into the command bar and press DISPATCH. The agent appears as a card on the roster; selecting the card puts its session on the stage.

That’s it — no config files, no manual MCP setup. The desktop app handles everything.

What Gets Installed

• Desktop App — A native app built around the five-row Floor: title bar, command bar, roster, stage, and doors bar. One screen; only the stage flexes.
• MCP Server — Structured access to your project state over the Model Context Protocol: 13 universal verbs (mm_create, mm_list, mm_get, mm_complete, …) plus a core catalog of about 22 tools listed by default. Configured automatically by the app. See the MCP Tools Reference.

CLI Alternative

If you prefer the terminal, you can also initialize projects with the mm CLI:

cd /path/to/your/project
mm init

This creates the same .mm/ directory structure the desktop app’s add-project flow creates. See Initialize a Project for details.

Next Steps

• Understand the data model — Learn how Monday Morning stores project state.
• Your first workflow — Create a spec, add tasks, and track progress end-to-end.
• The command bar — the one front door for dispatching agents.