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.
What you need
Section titled “What you need”- 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. Install Minion
Section titled “1. Install Minion”- Download the installer (
.msi) from Download Minion. If your browser stops the download (for example, “not commonly downloaded”), choose Keep in the downloads list. - Double-click the installer.
- 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.
- 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.
2. Approve the PC in Minion Workspace
Section titled “2. Approve the PC in Minion Workspace”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.
3. Sign in the minion account
Section titled “3. Sign in the minion account”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.
-
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-workerIf the PC is only for the minion, add
--autologon: Windows then signs in asminionby itself when it starts. -
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.
4. Set up the AI
Section titled “4. Set up the AI”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).
5. Check that it works
Section titled “5. Check that it works”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.
Updates
Section titled “Updates”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.
Day-to-day
Section titled “Day-to-day”| What | How |
|---|---|
| Is Minion running and connected? | minion status in PowerShell |
| Restart | Restart Agent on the minion’s page |
| Keep it running after a restart | Use --autologon (step 3), or sign in as minion after each restart |
| Keep the PC awake | Settings → System → Power: set sleep to Never |
Uninstalling
Section titled “Uninstalling”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.
Reinstalling
Section titled “Reinstalling”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.
- In Minion Workspace, open the minion’s Overview tab and click Reset pairing
- Install Minion again. On the approval page, under How to connect, choose Reattach to an existing minion and pick the minion
Running without a display
Section titled “Running without a display”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.
Troubleshooting
Section titled “Troubleshooting”Windows Security stops Minion
Section titled “Windows Security stops Minion”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.
minion isn’t on the sign-in screen
Section titled “minion isn’t on the sign-in screen”If net user lists minion but you can’t choose it on the sign-in screen, check these:
- Is the password set? Run
net user minionin PowerShell. If Account active is No, it isn’t yet: runminion configure-worker(step 3). - Did
configure-workerfail?minion: worker setup requires administrator rights: open PowerShell again with Run as administrator.minionis 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.
- 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. - 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
.\minionas 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 doesn’t open
Section titled “Screen sharing doesn’t open”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.
The minion stays offline
Section titled “The minion stays offline”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).