Install
NeuroSquad comes as a ready-made installer for Windows 10 and 11 (64-bit). The download is a small web installer (160 KB): it fetches the latest version (about 100 MB), checks its SHA-256 checksum and starts setup. There is nothing to build and no terminal involved. On a Mac, see Install on macOS; a Linux version is coming later.
Go to the download pageNeuroSquad-Installer.exe — it fetches the latest version and checks it.Open the download page on our site and press Download for Windows. When you run it, it downloads the latest NeuroSquad, checks it and opens setup.
The installer isn’t code-signed yet, so Windows may show a blue Windows protected your PC
window. Click More info, check that the app is NeuroSquad-Installer.exe, then press Run
anyway.
The Install location is filled in for you: %LOCALAPPDATA%\Programs\NeuroSquad. Keep it, or
pick another folder with Browse… — the line below shows how much space NeuroSquad needs
(369 MB) and how much the disk has free. Leave Desktop shortcut on if you want a NeuroSquad
icon on your desktop.
The default folder installs NeuroSquad for your Windows account only, and the note at the bottom says no administrator rights needed. A folder such as Program Files says needs administrator rights · Windows will ask instead — Windows then asks for permission when you press Install.
The window shows each step, how many files are unpacked and a progress bar. Show log opens the setup log: every file with its size and checksum, with timestamps. Cancel works while the files are being unpacked, and removes whatever was copied so far.
When you see NeuroSquad is installed, press Launch NeuroSquad. From now on it’s in the Start menu (and on the desktop, if you kept the shortcut).
SmartScreen shows that warning for any new app that isn’t signed with a certificate yet. Only ever download the installer from our download page .
Install from a terminal
The same installer, unattended: for your Windows account, without administrator rights. Every way checks the download against its SHA-256 checksum before running it, and NeuroSquad keeps itself up to date afterwards whichever way you installed it.
winget — Windows Package Manager, built into Windows 10 and 11:
winget install NeuroSquad.NeuroSquadScoop — adds the NeuroSquad bucket, then installs into Scoop’s apps folder:
scoop bucket add neurosquad https://github.com/glmn-ai/scoop-neurosquad
scoop install neurosquadPowerShell — downloads the latest version, installs it into
%LOCALAPPDATA%\Programs\NeuroSquad and starts NeuroSquad (Windows PowerShell 5.1 or PowerShell 7):
irm https://neurosquad.ai/install.ps1 | iexSign in
On first launch NeuroSquad asks you to sign in to your NeuroSquad account — it’s free. Your browser opens app.neurosquad.ai: sign in with a code sent to your email or with Google, press Connect, and the app picks it up. Until then the app shows only its sign-in screen. Step by step, and what the app sends while you’re signed in: Account & sign-in.
The setup wizard
Once you’re signed in, NeuroSquad checks what your computer already has and offers to install what is missing. Nothing changes until you press a button, and every step can be skipped — the one exception is Node.js (below).
The AI agent your cards will run. If you already have one, the wizard says so. If not, pick Claude Code, Codex CLI, OpenCode or Kilo Code and press Install it for me — the wizard installs it with npm and shows exactly which command runs. No npm yet? The agent CLIs need it, so the wizard installs Node.js LTS by itself: the official archive from nodejs.org, checked against its published SHA-256, for your account only — no administrator rights. On Windows the installer already does this at install time when Node.js is missing; a Node.js you already have is never touched.
Git for Windows brings Git Bash, which terminal cards and isolated worktrees use. The wizard
installs it with winget — and always asks first.
The speech model for voice input isn’t part of the installer — it’s a separate download. Pick a model and press Download, or skip the step: dictation is optional and nothing else depends on it. You can download it later in Settings → Dictation; until then the status bar says Dictation: download the model. See Speech models.
Press Start working. You can reopen the same steps any time in Settings → Setup.
You still sign in to each agent the usual way — run it once in its card and follow its own login prompt. NeuroSquad never asks for your keys.
Updating
NeuroSquad updates itself. To update by hand, run NeuroSquad-Installer.exe from the
download page again — it always fetches the newest version.
Setup finds the installed version on its own: the location points at the existing install
folder, the button reads Update, and a note says your workspaces, agents and settings are kept —
they live in %APPDATA%\NeuroSquad, not in the app’s own folder.
If NeuroSquad is still running, the installer shows NeuroSquad is still running with every process that keeps its files busy — the app itself and the terminals of its cards — by name and PID. Close NeuroSquad yourself and press Check again, or press End them and continue (terminals open in NeuroSquad cards will stop).
The new version is unpacked next to the old one and swapped in only once it is complete. If the update fails or you cancel it, the version you had stays untouched.
Uninstalling
Open Windows Settings → Apps, find NeuroSquad and choose Uninstall (or run
Uninstall NeuroSquad.exe in the install folder). It removes exactly the files it installed, the
shortcuts and the Apps entry. Files you put into the install folder yourself stay.
Your data stays too, unless you turn on Also delete my NeuroSquad data (off by default). That
deletes %APPDATA%\NeuroSquad: the workspace list, agents, settings, dictation models and the
agents’ isolated worktrees — uncommitted work in those worktrees is lost. Your project folders are
never touched. See Where your data lives.
Unattended install
For IT admins and scripts, the installer runs without a window. The full installer of the newest
release is at https://neurosquad.ai/downloads/NeuroSquad-Setup.exe; the web installer passes the
same options on to it.
NeuroSquad-Setup.exe --silent [--dir <folder>] [--no-desktop] [--launch] [--close-app]--dir— install location (default:%LOCALAPPDATA%\Programs\NeuroSquad, or the existing install)--no-desktop— no desktop shortcut--launch— start NeuroSquad when done--close-app— end running NeuroSquad processes instead of failing
Exit codes: 0 installed, 1 failed, 2 files in use (NeuroSquad is running and --close-app
wasn’t given). To uninstall silently:
"Uninstall NeuroSquad.exe" --silent [--delete-data]If something goes wrong
The failure page says what happened in plain words, shows the details and the log, and offers Try again. If the installer fails before replacing anything, your previous version still works.
The installer keeps a full log of every run in %TEMP%\NeuroSquad-Setup-<date>.log, and a copy of it
as install.log in the install folder. Press Copy log or Open log file in the log panel, and
attach the log when you report a problem.