Getting Started

Monday Morning is a context recovery layer for AI-assisted knowledge work. It stores structured project state in a .mm/ directory inside your repo so AI agents can pick up where you left off.

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. Sign in — Launch the app. You’ll land on the sign-in screen. Create a Monday Morning account or log in with an existing one.

3. Connect Claude Code — Monday Morning needs the Claude Code CLI to power sessions, briefs, and AI features. If it’s not already on your machine, the app shows a banner with a one-click Install button. Once installed, authenticate Claude in a terminal:

   claude login

   Tip

   If you already have Claude Code installed and authenticated, there’s nothing to do — the app detects it automatically.

   New to Claude?

   Claude Code is Anthropic’s CLI for working with Claude. Monday Morning uses it under the hood for all AI features. You’ll need an Anthropic account — claude login walks you through the setup.

4. Add a project — On first launch you’ll see a welcome screen, then a guided setup:

   • Browse — Pick a directory (any existing repo or folder).
   • Confirm — Preview the project name, choose a category (Work / Personal).
   • Set up — One click. The app creates the .mm/ directory, installs commands and agents, and registers the project.

   Already have projects? Click Add Project in the sidebar at any time.

   Tip

   New here? The setup wizard offers a demo project seeded with a real design handoff so you can explore without touching your own code.

5. Set up your roadmap — After adding a project, a kickoff flow opens where you describe your product vision and upload any materials (design handoffs, docs, screenshots). Monday Morning uses this to generate your initial roadmap and specs.

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

What Gets Installed

• Desktop App — A native Tauri app that orchestrates Claude Code sessions across all your projects from a three-column shell. See the Desktop App overview.
• MCP Server — 54+ tools exposed through the Model Context Protocol so Claude Code can read and update your project state. Configured automatically by the app.

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 that the desktop app wizard 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.
• Meet the Conductor — the AI orchestrator at the center of the desktop app.