Primary navigation

For Windows – ZeroTwo desktop app

Install and use the desktop app on Windows with PowerShell and approval-based safety

Scheduled tasks, Git settings, plugins and skills, file previews and the built-in browser are all covered by the Windows desktop app. It is built for x64 and runs on Windows on ARM through emulation. Commands run in PowerShell.

Download the desktop app

Get the installer from the download page at zerotwo.ai/download, run it, then follow the quickstart. The installer is large, so expect a sizeable download. It is signed by ZeroTwo Innovations Inc., but a new build can still trigger the SmartScreen prompt "Windows protected your PC". Choose More info, confirm the publisher, and then Run anyway. There is no winget package.

Updates are opt-in: the sidebar offers a download when a new version exists, then asks you to restart to install it. Check for Updates is also available from the menu.

Safety on Windows

ZeroTwo applies an operating-system sandbox only on macOS. On Windows, shell commands, the Node REPL and command hooks are guarded by approvals instead: with the Ask for approval preset, anything beyond a plain read asks first. The default, Approve for me, sends those requests to an automatic reviewer instead of to you. If you choose the Windows Subsystem for Linux agent environment, commands instead run inside your WSL distribution with a sandbox; see below.

Full access removes the approval prompts entirely, and scheduled tasks always run with full access. Keep the default preset for work you are not watching, and review the permissions page.

Customize for your dev setup

Opening files

In Settings > General, Default file open destination chooses between File Explorer and your default app for the files ZeroTwo opens. The Open with button in the file viewer lists other installed apps.

Terminal

Default terminal location puts new terminal tabs at the bottom or on the right. By default the agent's shell is PowerShell: Windows PowerShell 5.1, or PowerShell 7 (pwsh) when it is installed and a task asks for it. Bash, zsh, sh and cmd are not available as agent shells on Windows, but you can run the agent in WSL instead, as described next. See the integrated terminal.

Run the agent in WSL

Open Settings > General and set Agent environment to Windows Subsystem for Linux (the other choice is Windows native). A WSL distribution picker then appears, defaulting to your default distribution. WSL 2 is required, and a WSL 1 distribution is listed as such but cannot be used.

With WSL selected, the agent's commands run inside that distribution, sandboxed with bubblewrap, so Windows gains a real command sandbox. ZeroTwo checks the distribution when you pick it. The status line reads Commands run sandboxed in the distribution's name when it is ready, and otherwise says what is missing, such as WSL not being installed or no distribution being present.

Useful developer tools

Git features need Git for Windows, and pull-request actions use the GitHub CLI once you run gh auth login. Install either from a terminal:

winget install --id Git.Git
winget install --id GitHub.cli

Troubleshooting and FAQ

Git features are unavailable

Install Git for Windows, which ZeroTwo looks for in its usual install locations, then restart the app.

A command keeps asking for approval

That is expected on Windows because there is no sandbox to contain it. Approve once for the task, or pick Approve for me or Full access if you accept the trade-off.