Agent View for Claude Code
A VS Code panel to spawn, orchestrate, and monitor multiple Claude Code agents — each
running in its own isolated git worktree/branch — without leaving your editor. Runs in
VS Code and VS Code-based IDEs (Antigravity, Cursor, Windsurf, …).
Unofficial. This is a community-built extension. It is not affiliated with,
endorsed by, or sponsored by Anthropic. "Claude" and "Claude Code" are trademarks
of Anthropic, PBC, used here only to describe interoperability. You need your own
Claude Code installation and Claude subscription to use it.
Status: v0.7.0 — discovery, worktree spawning, live status, the React detail view,
desktop notifications, ambient "now doing X" status, Agent Race (best-of-N),
Fan-out, live plan progress, failure detection, Review & Land, a Teams
cockpit, Unattended Fleet, Evidence Gates, Live presence, and a
Fleet Shift Report.
New in 0.7.0 — the CaaC release: the Session Board (any session materialized
into episodes, plans, commits, and evidence instead of a scroll — it replaces the
Pinboard) and the Scroll (a clickable one-tick-per-event session minimap in the
Detail view, on the board, and in the Shift Report).
Expect rough edges; issues and PRs welcome.
Install
Published on the VS Code Marketplace and Open VSX.
Requirements: Claude Code on your PATH, and a Claude subscription.
Why
Claude Code can run many sessions and subagents at once, but there's no native
in-editor way to see them all, know which one needs your input, and steer them.
Agent View gives you one Agents panel: a live fleet list + a detail view, plus
one-click spawning of parallel agents in clean worktrees.
Features
- Agents panel — a live tree of every Claude Code session discovered from
~/.claude/projects, showing status (idle / running / thinking / needs-you), model,
and token/cost, with a React Detail view of the transcript. A parent delegating to
subagents shows thinking with a count of its working subagents; older idle agents
tuck behind a one-click recency toggle (mas.recentHours, default 24h).
- Live plan progress — when an agent keeps a to-do list, its own plan shows as a
4/7 · <current step> chip in the tree, the Detail view, and the Session Board — the
agent's ground-truth "now doing X", derived from its plan with no extra LLM calls.
- Failure detection (no LLM) — a red tests-red / command-failed chip when an
agent's most recent tool ends in failure (e.g.
Bash failed: npm test exited 1),
read straight from the transcript so it works for external agents too. It feeds the
status, the tree, and the Attention Router's reason.
- Fleet Pulse — a one-line status-bar heartbeat (
2 running · 1 needs you · 3 idle)
that stays visible even when the panel is closed and turns the warning color the moment
an agent needs you; click it to jump straight there. Toggle with mas.statusBar.enabled.
- Dismiss "needs you" — a stuck
waiting/error agent can be dismissed back to idle
inline in the tree, from the status bar ("Dismiss all"), or from the inbox. It quietly
resurfaces the moment the agent does something new, so you never lose a real ask.
- Session Board — open any session as a board instead of a scroll (from the
Agents toolbar). The transcript is materialized into objects — swim-lanes by
type, columns by episode (one per human prompt): the prompt with its numbered
requirements as chips, the agent's TodoWrite plan as one living object, the model's
own notes, verification evidence, collapsed machinery counts (with silent-stall and
unrecovered-error flags), and commit milestones. A Glance/Detail zoom answers
"what happened in these three hours?" in about a dozen objects. Click objects and
Send to point an agent at them — deixis instead of paraphrase; the selection
lands in
.agentview/board/selection.json exactly as before. Derived from a real
materialized-session design probe (Canvas as a Conversation); everything is parsed
from the transcript with no LLM calls.
- The Scroll — a session minimap: every conversational event as one tick, in
order — you (amber, widest), model prose, thinking, tool calls, results. It sits
above the Detail transcript (click a tick to jump), tops every Session Board
(click to jump to an episode), and gives each agent a shape line in the Fleet
Shift Report. A 3-hour, 999-event session reads at a glance — and the six amber
ticks show exactly where you steered it.
- Teams cockpit — a Teams mode on the Session Board that visualizes an active
multi-agent run live and read-only: the roster of named teammates (with a
plan
badge for plan-approval, live status, and tokens) and the shared task list rendered
as a dependency graph — a topological DAG with owner badges and a derived blocked
state, parsed from the lead's plan. Workflow fan-out runs show as chips, and it
auto-detects Claude Code's native Agent Teams store if it ever appears.
- Spawn in isolated worktrees — one-click New Agent creates a fresh git
worktree + branch so parallel agents never clobber each other's files.
- Live status — Claude Code hooks stream real-time events; transcript replay is
the zero-config fallback.
- Ambient "now doing X" — every agent shows a live one-liner of its current
action ("Editing auth.ts", "Running: npm test"), derived from hook tool events
with no extra LLM calls.
- Live presence — Explorer and tab badges (
AI) on files an agent is editing
right now, fading after 45s of inactivity, so you never open a file blind while
an agent is mid-edit. mas.presence.enabled to turn off.
- Notifications — a toast (and optional chime) when an agent needs your input,
finishes, or hits an error, so you can walk away and get pinged. Fully configurable
under
mas.notifications.*.
- Agent Race (best-of-N) — spawn N agents on the same prompt, each in its own
worktree, and compare them side by side in the Race tab: live status, "Open all
diffs", an optional Rank with AI pass, and Pick winner (opens its diff and
copies the
git merge command). Nothing is merged or deleted automatically.
- Fan-out — paste a checklist (or select lines in any file) and spawn one
worktree-agent per task, capped at
mas.fanout.maxConcurrent so the rest queue.
- Per-agent actions — open diff, focus terminal, or stop a managed agent inline.
- Evidence Gates — when a spawned agent finishes, its worktree is verified
automatically: the project's checks (
typecheck/lint/test scripts, tsc,
cargo/go — or your own mas.evidence.commands) run inside the worktree and show as
a checks ✓ / checks 1/3 ✗ chip in the tree and Review & Land. Evidence is
fingerprinted against the worktree's content, so proof from before new edits reads
checks stale instead of passing for current work; identical content is never
re-verified. Auto-detected commands ask once per repo before ever running.
Optional: mas.evidence.blockLandOnRed (hard-block landing unverified work) and
mas.evidence.selfRepair (hand failing output back to the agent, capped, then
escalated). Run Evidence Checks / Show Evidence Report in the row menu.
- Fleet Shift Report — a one-command briefing of what the fleet did while you
were away: a "waiting on you" list plus a per-agent table of status, plan, diff
size, evidence verdict, tokens, and estimated cost. Opens automatically when
Unattended Fleet turns off. Optional consent-gated AI narrative on top
(
mas.shiftReport.aiNarrative, off by default).
- Unattended Fleet — a governed auto-pilot (toolbar toggle). Spawned agents
auto-accept edits (
--permission-mode acceptEdits) while Bash still prompts
and escalates to you; agents that stall mid-plan get nudged to continue (capped,
then escalated); and a cost meter in Fleet Pulse plus a per-agent budget cap
that pauses an overrunning agent (branch/diff kept). Off by default; fully configurable
under mas.unattended.*.
- Review & Land — a Review tab that turns each spawned agent's work into a
reviewable, landable unit: every changed file as a native side-by-side diff (committed,
uncommitted, and untracked, against the exact fork point), a
+/− stat with the
agent's plan and tests-red state, request changes that route back to the running
agent, and one-click Squash-merge / Open PR (gh, with a copy-link fallback).
Landing is off by default (mas.review.allowLand), refuses a dirty base, snapshots
uncommitted work so what you reviewed is what lands, and is reversible until you push —
nothing is auto-merged and no branch is ever deleted.
- Opt-in AI helpers (off by default, consent-gated before first run):
- Conflict Radar — local-only; flags files edited by more than one agent.
- Attention Router — triages which agent needs you into a "Needs you" inbox.
Runs
claude -p and uses your Claude subscription.
- Merge Advisor — ranks multiple agents' diffs and recommends which to merge.
Uses your Claude subscription.
Architecture
┌─────────────────────────────────────────────────────────────┐
│ VS Code extension host (TypeScript, esbuild → dist/) │
│ │
│ data layer orchestration live status │
│ ─────────── ───────────── ─────────── │
│ discovery.ts worktree.ts hooks/server.ts │
│ transcript.ts spawn.ts (HTTP, push) │
│ subagents.ts registry.ts hooks/installer │
│ store.ts (fs.watch) terminals.ts │
│ │ │
│ ├──► AgentsProvider (native TreeView: mas.agents) │
│ └──► WebviewProvider (React detail: mas.detail) ◄───┐ │
└───────────────────────────────────────────────────────────┼─┘
webview-ui/ (React + Vite)
Opt-in AI layer (off by default): src/features/{router,mergeAdvisor,conflicts} plus
src/llm/runner.ts power the "Needs you" inbox, Merge Advisor, and Conflict Radar.
Data sources (fidelity order)
- Claude Code hooks (push, low-latency) — installed into
~/.claude/settings.json,
POST events to the local hook server. Drives real-time status.
- Session JSONL transcripts (pull/replay, zero-config) —
~/.claude/projects/<enc-cwd>/<session-id>.jsonl plus
<session-id>/subagents/**/agent-*.jsonl. Source of truth + fallback.
For agents the extension spawns, we pass claude --session-id <uuid> so each agent maps
deterministically to its transcript file.
Develop
npm install
npm run build # builds the React webview (Vite) + the extension (esbuild)
# then press F5 in VS Code to launch the Extension Development Host
Or iterate on just the extension host:
npm run watch # esbuild watch
npm run typecheck # tsc --noEmit
Contributing
Issues and pull requests are welcome — this is an unofficial community project.
Build from source (above), then open a PR against main.
License
Apache-2.0 — see LICENSE. Adapted OSS components are credited in NOTICE.
| |
