To install Crewly on Windows, open PowerShell and run irm https://crewlyai.com/install.ps1 | iex, then open a new terminal and run crewly start. The script installs Node.js, Git for Windows and jq if they are missing, and Windows may ask for administrator permission while it does. Crewly runs natively on Windows 10 and 11 with no WSL: each agent's terminal runs in Git Bash. The installer sets up Crewly 1.39.1 or later, which keeps Chinese and other non-ASCII text intact in agent skills. Windows support is still early, so read the last section too.
Before you start
- Windows 10 (version 1809 or later) or Windows 11, with winget. The installer uses winget, which comes with them in the App Installer package. If winget is missing, the script says so and links to manual downloads.
- One AI coding CLI, installed and signed in. Claude Code:
npm install -g @anthropic-ai/claude-code. Codex:npm install -g @openai/codex.
Install and start
- Run the installer. In PowerShell:
irm https://crewlyai.com/install.ps1 | iex. It checks Node.js 22 or later, Git for Windows and jq, installs what is missing with winget, then runsnpm install -g crewly. Windows may ask for administrator permission for Node.js and Git; the script says so first. Anything already installed is skipped. - Start Crewly. Open a new terminal and run
crewly start. It launches the backend and prints the dashboard URL (port 8787 unless you changed it). It does not open your browser by default: open the URL yourself, or runcrewly start --open. If something seems off, runcrewly doctor. - Finish setup in the dashboard. While your AI CLI is missing or signed out, the dashboard takes you to a setup page, where you install and sign in to it, pick a starter team and send a first task. After that the dashboard shows a short Get started checklist.
- Accept Claude Code's one-time prompt. The first time agents start on a computer, Claude Code asks you to accept Bypass Permissions mode. Answer it at that PC. With Slack connected, Crewly DMs you the question and you can reply
accept bypass. Nothing is accepted without your reply.
Check on it with crewly status; end it with crewly stop.
If the one-liner does not work
Install by hand. You need Node.js 22 or later, Git for Windows (Crewly starts every agent session in its bash.exe; if Git is somewhere unusual, set CREWLY_SHELL or CLAUDE_CODE_GIT_BASH_PATH to the full path of bash.exe) and jq (winget install jqlang.jq). Then run npm install -g crewly, open a new terminal and run crewly start.
Start Crewly when you sign in
Run crewly service install. It adds a per-user sign-in entry, a small supervisor that restarts Crewly if it exits, and a scheduled task every 5 minutes that revives a missing supervisor. It needs no administrator rights, and nothing runs before you sign in. crewly service status shows each piece and crewly service uninstall removes them.
What is not verified
- Crewly has run on a Windows PC of ours with a real team; support is still early, and nobody outside the team has done a clean install.
- The one-line installer passed on a Windows PC of ours where Node.js, Git and jq were already installed. The step that installs missing ones with winget was only tested in simulation, not on a real PC.
- Only Claude Code and Codex are covered. Gemini CLI and OpenCode are untested on Windows.
- Computer use (agents driving your mouse and keyboard) is macOS-only.
FAQ
Do I need WSL to run Crewly on Windows?
No. Crewly runs natively on Windows, and agent terminals run in Git for Windows' Git Bash, so what you need is Git for Windows, not WSL.
Which AI coding tools work on Windows?
Claude Code and Codex are the two confirmed in Crewly's Windows changes: it finds claude.exe, claude.cmd and the Codex command. Gemini CLI and OpenCode are untested on Windows.
Is there a one-line installer for Windows?
Yes. In PowerShell, run irm https://crewlyai.com/install.ps1 | iex. The macOS and Linux installer, install.sh, does not run on Windows.