Manage your Claude Code agents in Raycast A new Raycast extension called Claude Fleet lets developers manage Claude Code agents, pull requests, and worktrees directly from the Raycast launcher, reading Claude's session registry to show live agents without hooks. The tool provides 14 commands for spawning agents, reviewing PRs, and switching contexts with a single keystroke, aiming to reduce terminal context-switching. See your Claude Code agents, PRs, and worktrees in Raycast — and hand any of them to an agent in one keystroke. Plus an ambient menu-bar read on who needs you . Note Built and in daily use as a local Raycast dev extension. Full design in SPEC.md . Liveness needs no hooks — the extension reads Claude Code's own session registry ~/.claude/sessions directly, so active agents show up out of the box. The bundled helpers /vmc-7645/claude-fleet/blob/main/helpers add the richer touches Focus Tab, per-turn state, Spawn, Undo . Every dev surface — a PR, an issue, a running agent, a past session, a worktree — carries a one-keystroke hand it to an agent action. That's the whole idea: stop context-switching to a terminal to start work; start it from wherever you already are. Fourteen commands, grouped by what you reach for. | Command | Mode | What it does | |---|---|---| Spawn Agent | New Session Repo pickers Review PR · New Session · Spawn are recency-sorted: your localrepos first, then everything you can access onGitHub— remote picks are cloned on demand. The Claude Fleet commands in Raycast. Prerequisites: macOS · Raycast https://raycast.com · Claude Code https://claude.com/claude-code · gh https://cli.github.com · git · jq · a terminal Ghostty https://ghostty.org recommended 1 — clone git clone https://github.com/vmc-7645/claude-fleet.git && cd claude-fleet 2 — install the shell helpers + hooks idempotent; wires ~/.claude/settings.json, backs it up first helpers/install.sh 3 — sign in to GitHub for My PRs / PRs to Review / My Issues gh auth login 4 — load the extension into Raycast persists after you stop the dev server cd extension && npm ci && npm run dev Then two one-time steps: Restart Claude Code so the new hooks load. Grant Raycast Accessibility — System Settings → Privacy & Security → Accessibility → enable Raycast . Needed for the tab-focus / keystroke actions; gh reads work without it. That's it — open Raycast and search Claude Fleet . Preferences Raycast → Extensions → Claude Fleet → ⚙️ Terminal — where agents open: Ghostty default , iTerm2, or Apple Terminal. Focus Tab / Nudge / Close Tab need Ghostty per-tab accessibility ; every other action Resume, Fork, Review, Spawn, New Session… works on any of them. Agent primary action — Focus Tab vs Resume in New Tab what Enter does on a live agent . Quick replies — comma-separated canned follow-ups for the Quick Reply action. Editor command — code / cursor / … for Open in Editor must be on PATH . Repos directory — override discovery root. Blank → ~/.config/claude-fleet/repos.env → ~/Repos . The extension is a thin, declarative UI over a few data sources it reads directly — no daemon, no polling service, nothing to keep running. Where each fact comes from | Source | Gives | |---|---| ~/.claude/sessions/ .json | Active agents — Claude's own live registry sessionId · cwd · pid · busy/idle . Authoritative liveness, no hooks needed. | ~/.claude/projects/ .jsonl | Recent sessions — title aiTitle , pending question last assistant message , turn count, token usage. Parsed metadata is cached by file mtime. | ~/.claude/fleet/ .json | Optional enrichment from the fleet-register hook — finer state waiting / done , task label, diff, mode. | gh | Cross-repo PRs & issues, CI rollup, remote repo list. | The local commands + hooks the extension drives are vendored in helpers/ claude-worktree , claude-undo , claude-restore , and the tab-status / fleet-register / checkpoint hooks — see helpers/README /vmc-7645/claude-fleet/blob/main/helpers/README.md . The extension degrades gracefully without them: Focus Tab falls back to raising the terminal; Spawn / Undo report the missing command. The tab-status hook titles each Ghostty tab