Skip to main content

Advanced Windows configuration

Regular users only need the Windows installation for their first setup. This page covers login startup, fixed versions, WSL, browser capabilities, and removal.

Start after login​

After downloading $script as described on the installation page, run:

powershell -ExecutionPolicy Bypass `
  -File $script `
  -RegisterStartup `
  -Port 8765

The installer generates a Bearer Token, protects it with the current user's DPAPI, and starts AgentDock immediately. A newly generated token is shown only once, so save it in a password manager.

Connection details:

Transport      Streamable HTTP
URL            http://127.0.0.1:8765/mcp
Request header Authorization: Bearer <token shown by the installer>

This mode starts after the current user logs in. It is not a system service that runs before login.

Install a specific version​

powershell -ExecutionPolicy Bypass `
  -File $script `
  -Version vX.Y.Z

Run the installer again to upgrade. Existing runtime data and startup configuration are preserved.

Verify the installer script​

To verify the installer script before execution:

$base = 'https://github.com/uvwt/agentdock/releases/latest/download'
$script = Join-Path $env:TEMP 'install-agentdock.ps1'
$checksum = "$script.sha256"

Invoke-WebRequest "$base/install-windows.ps1" -OutFile $script
Invoke-WebRequest "$base/install-windows.ps1.sha256" -OutFile $checksum

$expected = ((Get-Content -LiteralPath $checksum -Raw) -split '\s+')[0].ToLowerInvariant()
$actual = (Get-FileHash -LiteralPath $script -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw 'AgentDock installer checksum mismatch.' }

The installer also verifies the AgentDock ZIP that it downloads.

WSL runtime​

When WSL is installed, command and file tools can select a Linux runtime explicitly:

{
  "runtime": "wsl",
  "wsl_distribution": "Ubuntu"
}

You may omit wsl_distribution to use the system default distribution. WSL file tools require python3 in the target distribution and use Linux absolute paths such as /home/... and /mnt/d/....

WSL writes reject symbolic links, device files, and special directories such as /proc, /sys, /dev, and /run. Cross-filesystem moves and recursive directory deletion are not currently supported.

Browser capabilities​

The Windows release does not install the browser runner automatically. Native mode requires Node.js, the runner from the source repository, and playwright-core. Regular users should prefer the Docker browser image, which already includes all dependencies. See Browser automation.

Commands and Skills​

  • exec_command prefers PowerShell 7, then falls back to Windows PowerShell or cmd.exe.
  • tty=true uses ConPTY.
  • Python, Node.js, and other platform dependencies declared by a Skill must be installed by the user.
  • The macOS Desktop Skill does not support Windows.

Remove AgentDock​

Download and run the uninstaller:

$uninstaller = Join-Path $env:TEMP 'uninstall-agentdock.ps1'
Invoke-WebRequest `
  https://github.com/uvwt/agentdock/releases/latest/download/uninstall-windows.ps1 `
  -OutFile $uninstaller
powershell -ExecutionPolicy Bypass -File $uninstaller

To also remove %USERPROFILE%\.agentdock and %USERPROFILE%\AgentDock:

powershell -ExecutionPolicy Bypass `
  -File $uninstaller `
  -PurgeState
danger

-PurgeState deletes tasks, Skill configuration, runtime data, and the default working directory. Back up anything you need before running it.