Introduction
Warshall is a desktop app for working with coding agents. It drives the agent command line tools already on your machine and puts the work around them in one window.
What it is
You open a folder as a project. Beside the file tree and the editor sit terminals, and each terminal runs a coding agent on that project. Claude Code and Codex are the providers terminal work goes to today. A model on an OpenAI compatible endpoint you add runs in a terminal too, through a loop of Warshall's own. Cursor and OpenCode have a row in Settings for their command line tools, but terminal runs do not go to them yet. See Providers.
The agent tools are not bundled with Warshall. It finds them on your machine. If you were already signed in to one before you installed Warshall, that sign in is adopted as a linked account, so you do not sign in twice. Git is found the same way.
The workspace
The workspace shows one project at a time. The file explorer is on the left, the editor in the middle and the terminals on the right.
The top bar carries, from left to right, the project switcher, Build, WorkMap, Terminals, Reviews and Git. At the right end sit the worktree history and the settings gear.
The Terminals view
The Terminals button opens every open project side by side, one column each, with that project's terminals under it. Across the bottom is one input box for the whole workspace. Type a request there and the orchestrator splits it into tasks, sends each one to a project and starts the terminals that run them. See the orchestrator.
What runs around a prompt
- Each terminal works in its own git worktree on its own branch, so parallel runs never touch the same files. Commits are written as the work lands.
- Every command an agent wants to run passes an approval gate. Your own rules sit on top of the built in ones.
- Stop losses end a runaway turn, and a ceiling on each account stops work once a weekly window is spent past the share you set.
- Usage for every linked account is read in one place, and the usage autopilot can spread queued work over all the accounts of a provider.
- The WorkMap draws the project as a diagram of features, and a terminal can be bound to the node it is working on.
- Reviews open over your own commits, with the diff and its full context inside the app.
Where things are kept
Projects, settings, WorkMaps, conversations, worktrees, saved prompts and the credentials of your agent accounts all live in one data folder on your disk. See the data folder.
A Warshall account is optional. You need one to add a person to a review by email. The mobile remote links your phone with a code instead. See Warshall account.