Quick Start

This guide covers the fastest way to run the MindMux desktop app locally.

Prerequisites

• macOS (arm64 or x64)
• Optional: locally installed Claude Code or Codex CLI for the built-in runtimes

Get the app

MindMux is currently in internal beta. The fastest path is to download a pre-built release:

1. Visit the mindmuxai/mindmux GitHub Releases page.
2. Download the latest .dmg file.
3. Drag MindMux into Applications and open it.

Open your first project

MindMux organizes work around a local project directory. After launch:

1. Select or create a project root folder.
2. MindMux will create brain/ and initialize the local runtime state the project needs.

Start your first session

In the main window:

1. Click New Session in the left sidebar.
2. Pick a runtime and an expert.
3. Send your first message, for example:
   • "Summarize the current architecture and open questions for this project."
   • "Turn today's discussion into brain pages."

MindMux will automatically distill "things that are now clear" into brain/pages/.

Create a task from discussion

When the discussion converges on an executable action:

1. Ask the agent to call create_task, or ask directly to create a task.
2. In the task confirmation card, choose the execution channel and isolation mode.
3. After confirming, the task appears in the right task panel and moves through dispatched → running → closed-success / closed-failed / closed-cancelled.

Next steps

• Read Workspace Model to understand the split between durable knowledge and local runtime state.
• Read First Session to learn how to make your first discussion valuable.
• Read Discovery to Brain for the daily knowledge-distillation workflow.