Initialize a Project

Add a project from first-run setup or the project switcher (+ add project). The app picks the folder, runs git init if needed, and installs everything below.

• Directory.mm/ — project data (specs, tasks, issues, notes, product docs)

  • config.json
• Directory.claude/

  • Directorycommands/mm/ — the /mm:* commands

    • …
  • Directoryagents/mm/ — agent definitions

    • …
  • CLAUDE.md — a managed block of project instructions
  • settings.json — auto-approves the project’s MCP servers

Setup never overwrites your files. Running it again only adds what’s missing.

mm init is a skeleton only

The mm init CLI creates the empty .mm/ folders and config.json, but not the /mm:* commands or agents. Use the app to set up a project fully.

Sharing

.mm/ is gitignored on purpose — your project context stays out of commit history. To share with teammates, set Settings → sharing to team visible (a signed-in team plan). Don’t force-add .mm/ to git.