---
title: "microManager docs"
description: "Documentation for microManager: getting started, workspaces, repository settings, scripts, environment variables, agents, MCP tools, shortcuts and fixes."
url: "https://micromanager.win/docs"
updated: "2026-11-08"
---

# 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 8 November 2026

[Migration guide](https://micromanager.win/migrate-from-conductor)

## What is in the docs?

1. [Getting started](https://micromanager.win/docs/getting-started)

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

2. [Workspaces](https://micromanager.win/docs/workspaces)

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

3. [Repository settings](https://micromanager.win/docs/repository-settings)

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

4. [Scripts](https://micromanager.win/docs/scripts)

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

5. [Environment variables](https://micromanager.win/docs/environment-variables)

   MICROMANAGER\_\* and CONDUCTOR\_\* variables, and how the ten ports per workspace work.

6. [Files to copy](https://micromanager.win/docs/files-to-copy)

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

7. [Agents and profiles](https://micromanager.win/docs/agents)

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

8. [MCP tools](https://micromanager.win/docs/mcp-tools)

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

9. [Keyboard shortcuts](https://micromanager.win/docs/keyboard-shortcuts)

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

10. [Troubleshooting](https://micromanager.win/docs/troubleshooting)

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

11. [FAQ](https://micromanager.win/docs/faq)

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

## Where do I start?

New to microManager? Read [getting started](https://micromanager.win/docs/getting-started); it covers installing on macOS, Windows and Linux. Moving from Conductor? Follow the [migration guide](https://micromanager.win/migrate-from-conductor), and save cloud work first with [how to export your Conductor workspaces](https://micromanager.win/export-conductor-workspaces). Something not working? Try [troubleshooting](https://micromanager.win/docs/troubleshooting).

Every page is also available as Markdown at the same address plus `.md`, and [llms-full.txt](https://micromanager.win/llms-full.txt) holds all of them in one file.