How do I see what every worktree is doing?
The Fleet pillar of the compass tool. Use it when several worktrees (or agents) work in parallel and you want to avoid collisions.
Question
What is every git worktree of this repo currently working on — which branch, story, task and PR?
Answer
Run compass.sh fleet:
./projects/ores.compass/compass.sh fleet
For each worktree it prints the branch, the mapped story and task (found
via the task's #+branch: field, read from that worktree's tree so it
works on unmerged branches), and the open PR with live state (via gh).
The current worktree is marked →; worktrees with no matching task
(e.g. main) are shown plainly.
-f json emits a structured array for tooling:
./projects/ores.compass/compass.sh fleet -f json
Script
projects/ores.compass/compass.sh fleet → src/compass.py (cmd_fleet),
using git worktree list, the task #+branch: fields, and one
gh pr list matched by head branch.
Tested by
Manual smoke test across the live worktrees. Read-only; degrades
gracefully (omits PR state) when gh is unavailable.
See also
- How do I see where we are? — the per-sprint
whereview. - Story: compass cross-worktree status — design and decisions.