Groundcrew

Dispatch your task backlog to local, interactive AI coding agents. One git worktree per task, sandboxed by default.

Groundcrew watches assigned tasks, creates isolated worktrees, launches agent CLIs in dedicated terminals, and leaves each task's work on its own PR-ready branch. For the backstory, read _Tickets to pull requests while you sleep_.

Why

- Local. Agents run on your machine with your tools, shell, and credentials. That makes them more steerable than remote agents, and easy to nudge when they drift.
- Interactive. Each task launches the real claude, codex, cursor-agent, or pi CLI in its own terminal pane, not a wrapper that approximates it. Watch any session live and take over when you need to.
- One worktree per task. Agents work in parallel without stepping on each other.
- Sandboxed by default. Safehouse or Docker Sandboxes isolate each agent on the host; none is an explicit escape hatch.
- Pluggable task sources. Linear by default; Jira and local files via task sources.
- Multi-agent routing. Ships claude, codex, cursor (plus a cursor-grok variant), and pi presets; bring your own CLI in config.

Prerequisites

crew doctor checks all of these, so you can install as you go.

- Node 24.22.1: nvm: nvm install 24.22.1.
- git: e.g., brew install git, apt install git.
- A terminal multiplexer: tmux (cross-platform), cmux (macOS), or zellij.
- An agent CLI: Claude Code, Codex, the Cursor CLI (cursor-agent, for the cursor and cursor-grok presets), and/or Pi.
- A sandbox runner: Docker Sandboxes (cross-platform) or Safehouse on macOS. Skip only with --runner none.

Quickstart

crew init --global writes config to ${XDG_CONFIG_HOME:-$HOME/.config}/groundcrew/. Pass --repo more than once for multiple repos. --agent claude, --agent codex, --agent cursor, or --agent…