Skip to content

Setting up a Windows minion

Install Minion on a Windows PC and the PC works as your minion. Minion runs as a Windows service, connects out to Minion Workspace (you don’t open any port) and updates itself.

  • Windows 10 or 11 (64-bit)
  • An administrator account — for installing Minion and for setting the minion account’s password
  • A Minion Workspace account
  1. Download the installer (.msi) from Download Minion. If your browser stops the download (for example, “not commonly downloaded”), choose Keep in the downloads list.
  2. Double-click the installer.
  3. If you see Windows protected your PC, click More info, then Run anyway. The Windows version is not code-signed yet, so this warning appears.
  4. When Windows asks for administrator permission, click Yes.

The installer creates a Windows user for the minion (user name minion), registers Minion Agent as a service and starts it. When it finishes, the Minion window opens.

The minion user stays disabled, and off the sign-in screen, until you set its password in step 3.

The Minion window shows a code and a link. Open the link while signed in to Minion Workspace (or open minionworkspace.com/pair and type the code).

The page shows the PC’s name, OS and the address it connected from. Check that it is your PC, give the minion a name, choose the workspace it belongs to (one where you are the owner or an admin) and click Approve. The code is valid for 10 minutes; if it expires, Minion shows a new one. The minion appears on the Minions page and connects within a few seconds.

The minion’s AI works as the Windows user minion, and only while that user is signed in on the PC. Until then, the minion’s page says Sign in to the minion account.

  1. Set the password (first time only). Open PowerShell as an administrator and run this command. Type the password twice (12 characters or more):

    Terminal window
    minion configure-worker

    If the PC is only for the minion, add --autologon: Windows then signs in as minion by itself when it starts.

  2. Sign in as minion. From the account button on the Start menu, choose Switch user and sign in as the minion (user name minion) with that password.

You can switch back to another user afterwards: the minion keeps working while minion stays signed in.

On the minion’s page in Minion Workspace, open the Brain tab, install Claude Code, then choose what the minion uses: Minion AI, your own Anthropic API key (how), or your own Claude plan (sign in from the tab; it opens the minion’s terminal in Minion Workspace).

On the minion’s page:

  • the minion is online
  • the Terminal opens a PowerShell as minion
  • Screen sharing shows the minion account’s desktop

Then send it a message from the chat.

Minion updates itself: it checks for a new version every few hours and installs it when the minion isn’t working. To update right away, use Update to version … now on the minion’s page, or run minion update --now in an administrator PowerShell. minion update shows the updater’s state.

WhatHow
Is Minion running and connected?minion status in PowerShell
RestartRestart Agent on the minion’s page
Keep it running after a restartUse --autologon (step 3), or sign in as minion after each restart
Keep the PC awakeSettings → System → Power: set sleep to Never

In Settings → Apps → Installed apps, select Minion and click Uninstall. The data Minion kept on the PC (the minion account included) is removed too. Then delete the minion on the Minions page if you no longer need it.

If you install Minion again on the same PC, you can connect it back to the same minion. What Minion Workspace keeps (its name, its workspace and project memberships, tickets assigned to it and so on) carries on. The data on the PC itself (memories, routines, to-dos and so on) was removed when you uninstalled.

  1. In Minion Workspace, open the minion’s Overview tab and click Reset pairing
  2. Install Minion again. On the approval page, under How to connect, choose Reattach to an existing minion and pick the minion

Screen sharing shows what the PC’s screen shows. With no monitor connected, it can be black or very small: plug an HDMI dummy adapter into the PC so Windows sees a display.

Windows Security (Microsoft Defender) may mistake Minion for a threat and stop or remove it. If that happens, please contact us.

The installer says an older minion is installed

Section titled “The installer says an older minion is installed”

A silent installation (msiexec /qn and the like) cannot ask whether to take the previous minion (the Node.js version) over, so it stops. Open the installer and answer its question, or install with TAKEOVER_NODE=1. See Switching to the new Minion.

If net user lists minion but you can’t choose it on the sign-in screen, check these:

  1. Is the password set? Run net user minion in PowerShell. If Account active is No, it isn’t yet: run minion configure-worker (step 3).
  2. Did configure-worker fail?
    • minion: worker setup requires administrator rights: open PowerShell again with Run as administrator.
    • minion is not recognized: that PowerShell was open before the installation. Open a new one, or run & "$env:ProgramFiles\Minion\minion.exe" configure-worker.
    • It fails at set worker password: the password doesn’t meet the PC’s password rules (for example, a company PC’s complexity requirements). Try another one.
  3. Are you looking for the right name? The sign-in screen shows the minion’s name from Minion Workspace (Minion before you approve the PC), not minion.
  4. Still not in the list? On some PCs, such as ones joined to a company domain, local users don’t appear in the list. Choose Other user and type .\minion as the user name.

The minion’s page says “Sign in to the minion account”

Section titled “The minion’s page says “Sign in to the minion account””

The minion user isn’t signed in on the PC. Follow step 3. After a restart, sign in again unless you used --autologon.

Screen sharing shows the minion account’s desktop while it is the one on the PC’s screen. If another user is using the screen, switch to minion (or sign that user out) and try again.

Run minion status in PowerShell. If the service isn’t running, restart the PC. If it shows waiting for approval with a code and a link, open the link and approve (the Minion window in the Start menu shows them too).