Documentation

Everything microManager does on macOS, Windows and Linux, page by page: how workspaces and agents work, every repository settings key and environment variable, and fixes for common problems. If you are moving from Conductor, start with the migration guide.

Updated

Migration guide

What is in the docs?

  1. Getting started

    Install, import from Conductor or add a repository, and start your first workspace.

  2. Workspaces

    How a workspace is created, named, archived and restored, and what the sidebar marks mean.

  3. Repository settings

    Every settings.toml key, and which settings file wins when several set the same one.

  4. Scripts

    Setup, run and archive scripts: when they run, in which shell, with which environment.

  5. Environment variables

    MICROMANAGER_* and CONDUCTOR_* variables, and how the ten ports per workspace work.

  6. Files to copy

    How .worktreeinclude, file_include_globs and the .env* default bring ignored files along.

  7. Agents and profiles

    Built-in agent profiles, models, effort levels, permission modes and custom ACP agents.

  8. MCP tools

    The tools agents get from the micromanager MCP server, and how it is locked down.

  9. Keyboard shortcuts

    Every shortcut, the command palette, and choosing the key that sends a message.

  10. Troubleshooting

    Agents not found, pull request buttons, setup failures, ports, imports and chat history.

  11. FAQ

    Price, privacy, supported systems and agents, Conductor compatibility and updates.

Where do I start?

New to microManager? Read getting started; it covers installing on macOS, Windows and Linux. Moving from Conductor? Follow the migration guide, and save cloud work first with how to export your Conductor workspaces. Something not working? Try troubleshooting.

Every page is also available as Markdown at the same address plus .md, and llms-full.txt holds all of them in one file.

Get microManager

Free, no account, for macOS, Windows and Linux. It runs the agent CLIs you already have installed and signed in.

curl -fsSL https://micromanager.win/install.sh | sh

That installs it on macOS and Linux. On Windows, paste this into PowerShell:

irm https://micromanager.win/install.ps1 | iex