WARSHALL
Docs/Get started/Download and install

Download and install

Warshall is published for Windows today. macOS and Linux builds are not published yet.

Windows

Get the installer from the download page. It runs on Windows 10 and 11, 64 bit.

It installs for your user only, so it never asks for administrator rights. It lets you pick the install folder, which is %LOCALAPPDATA%\Programs\Warshall unless you choose another one. It adds a Start menu shortcut and no desktop shortcut.

The installer is not code signed yet, so Windows may warn you before it runs.

macOS and Linux

The download page lists both as not published yet. There is no build to install on either platform at the moment.

What is not installed with it

The installer holds the desktop app and nothing else. Git and the coding agent command line tools are never bundled. Warshall looks for them on your machine and tells you in Settings when one is missing. For the agent tools, Settings > AI Providers has an Install button that runs the install command for you. See Providers.

Updating

There is no automatic update. You install the new version over the old one.

  1. Close Warshall. The installer cannot replace files the running app holds open.
  2. Run the new installer. It upgrades in place, with the same install folder, the same Start menu entry and the same data folder.

An upgrade leaves your settings, WorkMaps, accounts, worktrees and conversations alone, because they live in the data folder and not in the install folder.

The data folder

The installed app keeps everything in .warshall inside your home folder. If a folder from before the rename is there, .codewright or .pulseworkspace, that one is used instead, so nothing is left behind.

A fresh install carries no sample data. With nothing saved yet it opens with no project, and a project without a WorkMap shows an empty map.

Moving the data folder

Set WARSHALL_DATA_DIR to an absolute path and Warshall uses that path as it is.

WARSHALL_DATA_DIR=D:\warshall

A launch given its own data folder this way also keeps its browser profile inside that folder, so the whole instance is one directory. The old name, CODEWRIGHT_DATA_DIR, still works.

One window at a time

Launching the installed app a second time brings the first window forward and exits, so the Start menu shortcut never opens a duplicate. Two launches pointed at different data folders each get their own window.

Removing it

The app lives in the install folder you picked. Everything it keeps lives in the data folder, which is somewhere else. Removing the app therefore leaves your settings, WorkMaps, conversations and worktrees where they are. Delete the data folder by hand when you want those gone too.

An agent sign in you had before Warshall stays in that tool's own folder. Warshall reads it where it is and never writes into it or deletes it.