Requirements
| Tool | Why | Check |
|---|---|---|
GitHub CLI (gh), logged in | wloop reads pull requests through GitHub’s GraphQL API with your gh login, and agents publish reviews and comments with it | gh auth status |
git | worktrees, fetches and the checks that keep a workspace from losing work; fetches must run without a password prompt | git --version |
| A workspace manager: Claude Desktop, Orca, or both | hosts the worktrees and the agent sessions; see below | wloop doctor |
Claude Code (claude) | the agent that runs every round; wloop registers its MCP server, hooks and skills in each Claude Code home | claude --version |
Workspace managers
Section titled “Workspace managers”You need at least one of them. With both installed, wloop serves both at once, and workspace_managers (by default ["claude-desktop", "orca"]) says which a new worktree goes to first.
| Manager | Hosts | Board | Check |
|---|---|---|---|
| Claude Desktop | Claude Code sessions, in worktrees under a root wloop owns | no | /Applications/Claude.app and claude on the PATH |
| Orca, running | any agent, in terminals; wloop drives it through its CLI and runtime | yes | orca --version |
Claude Desktop cannot start a session with your user settings alone, a strict or MCP-free session, or an agent home other than the default. Such a session, for example a review of a pull request whose project settings stay off, goes to the next manager in the list; with no manager able to launch it, the round fails and says why. wloop doctor reports each manager and each intent it cannot launch. Turn off PR Auto-fix in Claude Desktop’s settings: when it is on, Desktop starts turns of its own on your pull requests that compete with wloop‘s, and wloop cannot read the setting, so doctor only reminds you of it. See Configuration.
Claude Code is the only agent that runs rounds. Codex can run the bundled skills by hand: wloop install also copies them into ~/.agents/skills.
wloop doctor checks each of these and prints the command that fixes what is missing. wloop init runs the same checks first.
Platforms
Section titled “Platforms”- macOS runs everything: the daemon under a LaunchAgent, the menu bar, notifications, and the Slack login in the login Keychain.
- Linux runs the daemon, the cockpit, the terminal client and the CLI. There is no menu bar and no notifications, and you keep
wloop serverunning with your init system (see Install). The Slack source needs the macOS Keychain. wloop drives Claude Desktop through macOS’sopen, so on Linux Orca is the workspace manager.
Optional
Section titled “Optional”- Slack: a Slack app of your own, created from the manifest that wloop ships. See Connect Slack.
- The brief: a short preview of each pull request, written by one headless call of the agent per pull request and billed to your agent account. Off by default. See The brief.