Harness health and onboarding
How the app checks that Claude Code, Codex and opencode are installed, on PATH, recent enough and signed in, and the setup sheet shown the first time none is ready.
A chat or agent can only start on a harness that works. The app checks each of Claude Code, Codex and opencode on the environment's host and says what to fix, with the command to copy.
What is checked
| Check | How | When it fails |
|---|---|---|
Installed and on PATH | The program is looked up on PATH | Not found on PATH, with the install command |
Installed off PATH | The usual install folders are searched: ~/.local/bin, ~/.npm-global/bin, ~/.bun/bin, the harness's own folder (~/.claude/local, ~/.opencode/bin), /opt/homebrew/bin and /usr/local/bin | Installed at that place but not on PATH, with the folder to add to PATH in your shell profile |
| Version | --version | Older than the oldest version the app supports, with the update command |
| Signed in | The harness's own status command | Not signed in, with the sign-in command |
Each probe has 15 seconds to answer. When the version cannot be read, or the sign-in cannot be told, the row says "Couldn't read its version" or "Couldn't tell whether it's signed in"; those two do not count as broken.
Per harness
| Oldest supported version | 2.1.41 |
| Install | npm install -g @anthropic-ai/claude-code |
| Update | claude update |
| Sign-in check | claude auth status |
| Sign in | claude auth login |
Settings › Harnesses
The Agent CLIs section lists the three harnesses with their state: "Not checked yet", "Checking…", "Ready" with the version, or what is wrong. A row with a fix has a button, "Copy the fix", that puts the command or folder on the clipboard. Check again runs the checks once more.
The checks run where the selected environment lives, and the section says which place it checked:
- This computer: "Each agent CLI on this computer".
- WSL: when the selected group's folder is inside a WSL distro, "Each agent CLI in WSL" and the distro.
- A remote host: "Each agent CLI on" and the host, for an environment on a remote host.
The first launch
The first time the app starts, it checks the three harnesses on this computer. If none of them is ready once every check has answered, it opens a sheet, Set up a coding agent: "None of the agents the app runs is ready on this computer yet." It lists the same rows with their fixes to copy.
- Check again runs the checks again; the sheet closes once one harness is ready.
- Not now closes it.
The sheet is shown only once: whether a harness is ready or you close it, the app does not show it again, and the same checks stay in Settings › Harnesses. When a Gateway is already set up, the sheet is skipped, since Gateway chats need no harness installed.
ACP agents
ACP agents are not part of these checks. They are set up in Settings › ACP agents; see ACP agents.