Changelog

New features

Unified Observability Stack — a new claude-view-observability crate provides structured JSON logging with daily rolling files, correlation IDs, panic crash logs, and opt-in Sentry integration across the entire Rust workspace.

Request ID Propagation — every HTTP request gets a ULID x-request-id header that flows through WebSocket init frames, block pipeline phases, and tmux environment variables. Trace any operation end-to-end from browser to CLI session.

Crash Logs — unhandled panics now write crash-*.log files with full backtraces to ~/.claude-view/logs/, so you can diagnose issues even when the process exits unexpectedly.

OTLP Export — behind the otel feature flag, send traces to any OpenTelemetry-compatible backend (Jaeger, Grafana Tempo, Datadog) for custom dashboards.

Linux ARM64 Binaries — the release pipeline now builds for linux-arm64, supporting ARM servers and Raspberry Pi.

Improvements

• Release pipeline hardened with artifact verification contracts, build provenance attestations, and post-publish smoke tests
• Dev-loop recompile time cut 24-43% via Cargo profile tuning
• OpenAPI spec now includes field descriptions for all observability structs
• Dead dependencies removed from claude-view-core
• Anthropic pricing data synced to latest official rates

Getting started

npx claude-view@latest

New features

Archived project detection — projects whose directories no longer exist on disk are automatically detected and rendered in a collapsed “Archived” section within the Scope panel. A new project_dir_status table tracks directory existence, with smart startup backfill that probes each project directory without blocking the server.

Zero-poll PID resolution — the “born waiter” pattern replaces polling for CLI session identity resolution. An FSEvents watcher races against a 50ms fallback poll — in production, the watcher wins with sub-millisecond latency. New lifecycle debug instrumentation captures the full timing waterfall from POST /api/cli-sessions through to session identity resolution.

Improvements

Single-writer event-driven architecture — eliminated dual-path data flow where both imperative fetch and reactive SSE could create the same entity. Buttons now own fetch; parents react to callbacks. SSE syncs existing state but never creates.

Double session spawn fix — fixed a race where new CLI sessions could spawn two tmux processes instead of one.

Oracle stability — fast ticks no longer blank the top processes and disk gauges in the system monitor. Resource snapshots use Option-based fields to distinguish “not yet collected” from “empty.”

Git root inference — worktree paths now correctly walk up the directory tree to find the real .git root, fixing project detection for repos using git worktree.

Getting started

npx claude-view@latest

Fixes

First-run hang from untrusted directories — npx claude-view could hang indefinitely when starting a CLI session from a directory Claude hadn’t previously trusted (like $HOME). Claude CLI was blocking on its interactive “trust this folder?” dialog, but nobody was there to press Enter in the detached tmux pane, so the session never wrote pid.json and the API timed out with a 503 after 5 seconds. claude-view now sends Enter to the tmux pane automatically 1s and 2s after creation to auto-accept the dialog. For already-trusted directories the poll resolves in under 300ms and the Enter is a harmless no-op.

Improvements

Nested session detection — CLAUDE* environment variables are now stripped from the tmux command when spawning CLI sessions. This prevents Claude CLI from mis-detecting a nested session when the claude-view server is itself launched from inside a Claude Code terminal.

Getting started

npx claude-view@latest

New features

PID-driven session lifecycle — session detection now uses PID files as the single source of truth, replacing process tree scanning. A unified session store eliminates the dual-store split, and a two-tier oracle refresh (PIDs every 2s, full system every 10s) keeps the dashboard accurate with lower CPU overhead.

Zed-level terminal panes — new terminal pane layout with chrome elimination, zoom, auto-layout, and keyboard shortcuts. Each session gets a single identity — no more duplicate CLI panels.

Spawning status indicator — sessions now show a pulsing blue dot while booting. The Born handler enriches spawning sessions from tmux POST so you see the session the moment it appears.

CLI beta banner — experimental banner variant with dismiss functionality for upcoming CLI features.

Improvements

Tmux ownership reconciliation — server restarts no longer leave ghost sessions. Ownership is reconciled from tmux state on startup.

Bounded closed session ring — replaced unbounded HashMap with a VecDeque(100) ring buffer for closed sessions, capping memory usage.

Stabilized active sessions selector — useMemo-wrapped selector prevents spurious re-renders in the Live Monitor.

Dockview layout persistence — layout saves now flush on unload, visibility-hidden, and unmount — no more lost layouts on browser close.

PID publisher resilience — the oracle handles RecvError::Lagged by resyncing instead of dying, preventing silent monitoring gaps.

Getting started

npx claude-view@latest

Fixes

macOS ARM startup crash — fixed a panic during deep indexing caused by rustls 0.23+ failing to auto-detect the TLS crypto provider. Cargo feature unification compiled both ring and aws-lc-rs into the binary; the server now explicitly installs aws-lc-rs as the process-level CryptoProvider before any network I/O. Also applied to the relay binary for consistency.

Getting started

npx claude-view@latest

New features

Native Linux support — linux-x64 binary now ships in every release. No more CLAUDE_VIEW_ALLOW_LINUX=1 env var bypass.

Interactive CLI terminals — tmux CLI sessions render as real xterm terminals inside Chat and Monitor pages. Close button on terminal tabs lets you manage multiple sessions.

Webhook notifications API — CRUD API for managing webhooks with Lark and Slack formatters. HMAC-SHA256 signed deliveries with automatic retry. Test-send endpoint for validating configs before going live.

Session ownership model — new OwnershipTier type replaces the old LiveStatus enum. Cleaner session lifecycle with pid.json as the single root for live detection. All session list, sidebar, and badge components rewired.

Unified interaction UI — plan approvals, permission prompts, and user questions surface through a single interaction card system. bypassPermissions flows through the full plan approval path.

API authentication — API key generation and validation with cv_live_ prefix format. Tower middleware with automatic localhost bypass for local development.

Improvements

Zero-data-loss block rendering — 17 missing system variant renderers added to chat mode. Missing fields added across TurnBoundary, ToolChip, ToolCard, Interaction Cards, NoticeBlock, ProgressBlock, UserBlock, and AssistantBlock. TeamTranscriptBlock renderers for both chat and dev modes.

Claude Code plugin expansion — marketplace manifest for one-click plugin install. 18 MCP tools unlocked. System-monitor, live, and usage skills. OpenAPI drift check ensures all handlers stay documented.

Cross-platform terminal backend — replaced node-pty with Rust-native portable-pty, removing the native addon dependency that caused ABI mismatch issues.

Storybook gallery — AllBlocks mega-story for scrollable full gallery. 3-column comparison layout with a11y addon.

12 state-swallowing gaps closed — error reasons now carry through the full pipeline instead of being silently dropped.

TaskItem deserialization fixed — 23% of task files were silently dropped due to missing field defaults.

Getting started

npx claude-view@latest

Improvements

Pinned Rust toolchain to 1.94.1 stable — ensures reproducible builds across all contributors and CI environments with rust-toolchain.toml.

cargo-nextest routing in cq — ./scripts/cq test now automatically routes through cargo-nextest when installed, falling back to cargo test for --doc tests or when -- args are present. Faster test execution with better output formatting.

Rust tests added to pre-push gate — lefthook pre-push now runs cq test --workspace alongside clippy and cargo-deny, catching test failures before they reach CI.

Getting started

npx claude-view@latest

New features

Session Ownership Model — every session now carries computed ownership data (SDK-spawned, tmux-managed, or standalone CLI) enriched at both REST and SSE boundaries. No extra client requests needed — ownership is always available for display and filtering.

Runtime Configuration — new config.toml file with feature toggles. Configure behavior without recompiling the server.

Eager CLI Session Ownership — CLI sessions resolve ownership immediately on discovery with automatic stale refresh, so tmux and SDK relationships appear instantly.

Improvements

50% smaller binary — two-profile build split and feature-gated swagger reduce the release binary from 35MB to 17MB.

50MB heap reduction — two-phase Tantivy writer releases search index heap after bulk indexing completes.

Lazy sidecar initialization — the Node.js sidecar no longer spawns at startup, only on first use. Faster cold start.

Accurate macOS memory — process monitor now reports physical footprint instead of inflated RSS values.

Per-block error isolation — one malformed block in a conversation no longer crashes the entire chat view. Each block renders independently with its own error boundary.

Plugin remote install — fixed npm source and npx MCP pattern so claude plugin install works from the registry.

Shared tab components — extracted reusable TabContent and TabContextMenu from dockview, reducing duplication across chat and monitor panels.

Getting started

npx claude-view@latest

Improvements

Decomposed monolithic Rust files into focused modules — split ~69K lines of code across 3 batches into single-responsibility modules, improving build parallelism and code navigability.

Extracted 4 new independent crates — server-process-tree, server-live-state, server-types, and server-local-llm now compile in parallel with the main server crate, reducing incremental build times.

Fixed 49 E2E test failures — updated routes, selectors, and skip gates to match the new module structure.

Scrubbed PII from doc comments and tests — removed personally identifiable information from code documentation and test fixtures.

Getting started

npx claude-view@latest

New features

Team Debate Transcripts — view multi-agent discussions as clean conversation transcripts with progressive disclosure. Non-technical users see the debate flow; engineers can expand technical details. Dedicated cards for agent messages, moderator prompts, verdicts, and round dividers.

Team Sidechains — drill into sub-agent activity per team member. See per-sidechain cost and token usage, model info, timestamps, and duration. Event-driven refresh via inbox versioning — no polling.

Team Cost Breakdown — per-member cost breakdown with crown indicator for highest-spending member. Visible across all surfaces: sidebar, detail panel, and overview.

~/.claude Integration — browse your Claude Code memory files, settings, MCP servers, active sessions, and todos directly from the dashboard. Two-phase rollout: memory viewer + settings (Phase 1), MCP + active sessions + todos (Phase 2).

Memory Page Redesign — 2-column layout with resizable panel, type badges, and per-type memory counts.

Sessions Directory Watcher — live monitor now detects new sessions via filesystem watcher with startup scan and crash detection.

Improvements

• SessionCard layout redesign with amber as the new primary color
• Member Sessions moved from bottom panel to resizable right sidebar
• SSE-driven real-time team updates (replaces polling)
• Snapshot team data before deletion for recovery
• Member discovery from inbox filenames, not just senders
• External schema fields made optional to survive upstream SDK changes
• Stable-sort hook block merge to eliminate timestamp violations
• Block pipeline drift check added as CI gate 7

Getting started

npx claude-view@latest

Fixes

Correct cost total in Overview tab — the Overview tab now includes team sidechain costs in the total, matching the Cost tab and session card.

Tasks tab for historical sessions — the Tasks tab no longer disappears when persistent task files are cleaned up after a session ends. Falls back to progress items already parsed from JSONL.

Getting started

npx claude-view@latest

New features

Historical InteractionBlocks — Plan and Question blocks are now synthesized from historical JSONL data. Your full conversation timeline is complete even for sessions recorded months ago — not just live or recent ones.

Improvements

Cost estimate accuracy — plugged a 1-hour cache drift that was silently skewing token cost estimates. System message render gaps also resolved.

Crash-aware sidecar supervisor — replaced naked node --watch with a supervisor that detects crashes and restarts cleanly, eliminating silent failures during development.

Dev orchestration cleanup — replaced a 400-character inline concurrently command with a maintainable orchestrator script. Added dev-cleanup.sh to kill orphan processes (not just ports) after dev sessions.

Sidecar ownership gate — CLAUDE_VIEW_SIDECAR_EXTERNAL env var prevents the Rust server from spawning the sidecar in dev mode, eliminating the race between tsx watch and the production spawn path that caused phantom WebSocket failures.

Getting started

npx claude-view@latest

New features

Attachment blocks — files added or removed from Claude’s context mid-session are now visible as structured blocks in developer mode. See exactly what context changes happened and when.

Permission mode change blocks — when Claude’s permission mode shifts during a session (e.g. from default to bypassPermissions), it now appears as an explicit event in the timeline rather than being invisible.

Scheduled task fire blocks — when a scheduled task triggers and spawns a Claude agent, the trigger event is now rendered in the session timeline.

Improvements

Hook progress blocks de-duplicated — event and hook name were duplicated between the block header and the body. The body now shows only the status message and command, while the header carries the full event→name label.

Stdout no longer silently truncated — hard .slice() caps on hook command output and stdout have been removed. Long outputs now display in full. Height caps were also raised for better readability.

Block pipeline exhaustiveness enforced at compile time — the renderer switch is now a compile-time exhaustiveness check. Adding a new system block variant without a matching renderer is a type error, not a runtime blank.

Getting started

npx claude-view@latest

New features

On-Device AI settings — redesigned settings card with a provider-agnostic architecture. Select models from a dropdown, connect to any OpenAI-compatible endpoint, and manage local LLM integrations without oMLX-specific tooling.

Hook events in conversation — hooks now render as conversation blocks across three paths: live WebSocket streaming, historical API, and JSONL replay. See your pre/post tool hooks inline with the rest of the conversation.

Sub-agent pagination — sub-agent block views now paginate, so large agent sessions with hundreds of blocks load incrementally instead of all at once.

Server-side activity aggregation — the Activity page now uses a dedicated rich_activity() database function, replacing client-side computation with faster, more accurate server-driven data.

Improvements

Sidecar memory fix — removed listSessions() which spawned a full CLI process (900MB+ per call) on every invocation. The sidecar health endpoint now includes memory diagnostics for easier monitoring.

Historical sub-agent sessions — sub-agent WebSocket connections now fall back through live → recently_closed → database, fixing failures for 99% of sessions that aren’t currently live.

CLI plugin stdout fix — prevented Node.js stdout truncation at 64KB in CLI plugin commands by switching from pipe to tempfile-based output.

Block accumulator robustness — string-content user messages (not just array-content) are now correctly parsed by the block accumulator, fixing silent data loss.

Architecture cleanup — centralized session mutations into a shared multiplexed WS hook, extracted pagination to a coordinator-level module, and introduced an AppState builder pattern for the server.

Getting started

npx claude-view@latest

Fixes

Monitor data correctness audit — fixed all 15 findings from a comprehensive data audit. Eliminated FROM sessions leaks, added missing project_path filters, and upgraded all remaining 2-way project filters to 3-way (include/exclude/all) across trends, snapshots, insights, and contributions.

Activity heatmap & sparkline — charts now correctly respect the selected time range filter instead of showing all-time data. Daily timeline fetches on demand.

Activity page binding — fixed time range binding, project sort order, and backup session ingest. Removed a dead hook and protected backup sessions from premature pruning.

PhaseBadge dynamic model — badge now reads provider/model from settings instead of hardcoded values, and hides when on-device AI is turned off.

Improvements

App data consolidation — all app data now lives under ~/.claude-view/. One directory to manage, backup, or delete.

Getting started

npx claude-view@latest

New features

On-device AI with oMLX — claude-view can now run a local LLM for phase classification. Managed lifecycle with auto-detect, spawn, restart, and graceful shutdown. Model switching with a curated registry, RAM guard, and HuggingFace download with resume, cancel, speed and ETA display.

Smart phase classification — 93% GPU waste reduction through an exponential backoff drain loop. The classifier now uses EMA stabilization with temp-diversified voting, settling into a dimmed badge state when sessions go idle.

Component dashboard — the System Monitor replaces the self-app row with a full component view showing sidecar and oMLX metrics including VRAM usage, CPU, RAM, and session count per component.

Harness v3 — the Live Monitor gains a needs-you sidebar grouped by project/branch with collapsible headers, plus a redesigned Harness view with Design/Delivery swimlanes.

Help dropdown — new Help button in the header with keyboard shortcuts, release notes link, and feedback link. Auto-scrolls to the shortcuts section.

Improvements

Settings page polish — feature scope labels, unified card headers, GitHub star CTA, release notes link, build date in About, improved Mobile Pairing and Privacy UX.

SessionCoordinator — 4-phase mutation pipeline (lifecycle, statusline, reconcile, control) replacing the monolithic manager. The 4337-line manager.rs was decomposed into 8 focused modules.

25 hook events — expanded from 14 to 25 Claude Code hook events with explicit match arms for every event type.

Full API as MCP tools — OpenAPI spec generation with utoipa annotations, automatic codegen producing 85 MCP tools from the spec.

Unified block pagination — single source of truth for all block consumers, fixing pagination state loss after format changes.

Getting started

npx claude-view@latest

New features

Session entrypoint badges — history session cards now show how each session was started: CLI, VS Code, SDK, or other entrypoints. Visual badge on each card so you can filter and identify sessions at a glance.

Unified local CI pipeline — new ./scripts/ci-local.sh runs 8 sequential quality gates before every release: TS lint, typecheck, and tests; Rust clippy and workspace tests; evidence audit; Storybook build; and integrity gates. The release script now runs full local CI automatically.

Improvements

FSM-unified session views — all session views (history, live, watching) now run on a single finite state machine, replacing the legacy TanStack hook chain. Removed 5,841 lines of duplicated state management and fixed pagination drift that had been present for a month.

Stable scroll anchoring — fixed onStartReached callback instability across all pagination consumers. Inline anonymous functions and conditional ternaries replaced with stable useCallback references, fixing silent scroll anchoring breakage in Virtuoso.

Keyboard navigation fix — arrow keys in the sidebar no longer hijack focus from the chat input. Global keyboard navigation removed from sidebar to prevent input stealing.

Agent name parsing — the block pipeline now parses agent-name JSONL entries for better sub-agent identification in conversation views.

Evidence baseline sync — added a baseline-to-parser sync guard that prevents stale evidence drift, catching schema changes before they ship.

Getting started

npx claude-view@latest

Fixes

Sidecar proxy for production — added a reverse proxy in the Rust server for sidecar HTTP and WebSocket routes. In development Vite handles proxying to the sidecar on port 3001, but in production these requests were silently failing. The chat page now works correctly in production builds.

Light mode in chat page — DockviewReact was missing the theme prop, causing it to default to the dark Abyss theme regardless of system or user preference. The theme prop is now passed explicitly so light mode renders correctly.

Improvements

Smart port binding — the server now reclaims ports from stale claude-view processes and auto-increments (up to +10) when the port is held by another app, instead of failing on startup.

Stale sidecar cleanup — zombie Node processes on the sidecar port are killed before spawning a new instance, preventing EADDRINUSE failures.

Enterprise sandbox support — respects CLAUDE_VIEW_DATA_DIR for telemetry config path and CLAUDE_VIEW_SKIP_HOOKS=1 to skip hook registration in read-only environments.

Getting started

npx claude-view@latest

New features

Per-agent cost and token breakdown — the cost tooltip now shows which model each subagent used and how many tokens it consumed. Scrollable overflow handles sessions with many agents.

Agent group collapsing — conversation threads with nested agent groups can now be collapsed and expanded. Rich renderers with JSON syntax coloring make agent output easier to scan.

Persistent detail panel tab — the Live Monitor remembers your last-selected detail panel tab across sessions, so you don’t have to re-select it every time.

Improvements

Geist font system — replaced Fira Code and Fira Sans with Geist Sans and Geist Mono for a cleaner, more modern look across the entire app.

Apple HIG type scale — all font sizes normalized to Apple Human Interface Guidelines, giving consistent visual hierarchy from sidebar labels to conversation content.

“Not signed in” FAQ — new troubleshooting guide in the README covering credentials file, macOS Keychain, token expiry, and HOME environment issues.

Getting started

npx claude-view@latest

New features

Developer Rich mode — SOTA polish — Developer Rich rendering has been overhauled with improved visual hierarchy, contrast, and information density. Block cards now use consistent spacing, semantic color coding, and better typography for scanning long execution traces.

Enhanced block renderers — New dedicated renderers for sidechain blocks, image blocks, hook metadata, and retry events. Each block type now has a purpose-built card with proper icons, expandable details, and dark mode support.

Block pipeline integrity audit — New block-pipeline-audit.sh script and /block-integrity command that validates the full stack: Rust parser → generated TS types → React components → Storybook stories. Catches type drift and missing renderers before they ship.

Improvements

Chat mode visual identity — Chat mode UI now uses a semantic visual identity with refined typography, spacing, and color language that distinguishes it from developer mode at a glance.

Dark mode theme fixes — Fixed error border contrast across shared packages by adding the @source directive for cross-package Tailwind scanning. Added missing dark: variants to 29 hardcoded color classes that were invisible in dark mode.

Getting started

npx claude-view@latest

New features

SOTA session monitoring hardening — closed 5 gaps in session lifecycle tracking. Sessions are now identified by process ID instead of heuristics, eliminating misattribution when multiple Claude Code instances run in the same project.

Live statusline via SSE — Claude Code’s statusline updates (current file, tool use, thinking state) now broadcast to the Live Monitor in real-time via Server-Sent Events. The chat panel receives this context too, so you can see what the agent is doing without switching views.

PostHog telemetry integration — opt-in analytics with a polished consent UX. The API key is baked into release builds so telemetry works out of the box for users who opt in — no configuration required.

Improvements

Batch process scanning — process tree classification now batches ps calls instead of spawning one per session, reducing CPU overhead on machines with many concurrent sessions.

PID-based session identity — sessions use process IDs as their primary identity, replacing the previous heuristic approach that could confuse sessions sharing a working directory.

Getting started

npx claude-view@latest

New features

Multi-Session Chat (VSCode-style tabs) — open multiple Claude Code sessions side-by-side in a dockview tabbed layout. Drag tabs to split horizontally or vertically. Each panel maintains its own connection, scroll position, and state.

ConversationBlock Pipeline — a new Rust-native block accumulator parses JSONL into structured conversation blocks (user, assistant, progress, system, notice, turn boundary). Served via ?format=block REST endpoint and real-time WS block mode.

FSM Chat Panel — chat sessions are driven by a finite state machine with explicit phases (nobody → acquiring → active), typed events, and deterministic transitions. Eliminates an entire class of race conditions between connection, history load, and live streaming.

Developer Mode Overhaul — ToolCard, EventCard, CategoryFilterBar, and ThinkingIndicator replace the old raw-JSON terminal view. Toggle between Chat and Developer modes per session.

Session Source Detection — sessions are automatically classified by launch source (Terminal, IDE, Agent SDK) via parent process inspection. SourceBadge shown across all three pages.

Message Threading — parentUuid propagation enables indented sub-agent message display in ConversationThread.

Share Viewer Migration — the share viewer now uses the same ConversationThread + ConversationBlock rendering as the main app.

Improvements

• Direct TCP sidecar connection (port 3001) replaces Unix socket relay
• Worktree-state and forkedFrom JSONL types fully handled in parser
• Live session sidebar groups by urgency with source badges
• Sub-agent block view with WS error surfacing
• Sidebar project deduplication via real path GROUP BY
• EventSource auto-retry on transient SSE connection errors
• Loading indicator while fetching history blocks
• PII-check pre-commit hook
• ~5,800 lines of deprecated code removed (RichPane, ActionLogTab, ComparisonGallery)
• Evidence audit baseline updated for new Claude CLI fields

Getting started

npx claude-view@latest

Fixes

Share viewer developer mode — The share viewer now has a proper Chat/Developer toggle matching the main app’s design. Developer mode shows the full execution trace with filter chips (User, Assistant, MCP, Tool, etc.), so shared conversations can be inspected in detail.

Share blob raw data — Share blobs now include raw JSON data from the session, enabling accurate developer mode rendering with proper tool cards, system events, and metadata.

Getting started

npx claude-view@latest

New features

Shell Install — install Claude View with a single command: curl -fsSL https://get.claudeview.ai | sh. Auto-detects your platform, fetches the latest binary, and adds it to PATH. No Node.js required.

Fixes

Context Gauge Accuracy — fixed live sessions showing inflated context usage percentages (e.g. 84% when actual fill was 12%). The gauge now uses Claude Code’s own statusline data as the authoritative source, with a 4-tier priority fallback chain.

Improvements

• 49 new tests covering all chat lifecycle features: SDK hooks, watching mode, sidebar badges, race condition prevention, optimistic message dedup, and context gauge accuracy
• 3 regression tests guarding previously-fixed bugs
• Fixed 11 pre-existing test failures across multiple components

Getting started

curl -fsSL https://get.claudeview.ai | sh
# or
npx claude-view@latest

New features

Single-Stream Chat Architecture — replaced the dual-source merge model with a single-stream source selection pattern. User messages now echo back through the WebSocket, giving one source of truth for the full conversation. Auto-connect on page load, replay-complete signaling, and graceful buffer exhaustion make live sessions rock-solid.

Linux Keychain Credentials — added a secret-tool backend for reading Claude credentials from GNOME Keyring / Secret Service on Linux. Path scanning is now platform-universal.

Session Integrity — one WebSocket per session enforced (second connection closes the first with code 4001). No more stale state from duplicate connections.

Token & Cost Attribution — token/cost totals and sub-agent cost breakdowns are now visible in the session UI. Context window breakdown shows Used total and Available capacity.

Improvements

• Install tracking worker at get.claudeview.ai for download analytics
• Cross-platform release script (replaced BSD-only sed -i)
• Sidecar rebuilds correctly in preview, start, and dist:test scripts
• Removed macOS-specific /opt/homebrew from NPX path scan

Getting started

npx claude-view@latest

New features

Unified Model Catalog — single source of truth for all model metadata including pricing, context windows, and capabilities. Eliminates scattered hardcoded model data and ensures accurate cost calculations across all supported Claude models.

Fixes

Sidebar Deduplication — fixed duplicate project entries appearing when sessions were indexed after server startup. Non-worktree sessions now resolve git_root inline during indexing instead of relying on a one-shot startup backfill.

Status Line — suppressed curl response body from leaking into terminal output.

Getting started

npx claude-view@latest

New features

Unified search engine — Search now uses Tantivy full-text indexing as the primary engine, with automatic ripgrep fallback when the index returns no results. A SQLite pre-filter narrows candidates by project, date, and model before the full-text pass. Results from the grep fallback are labeled “Substring matches” so you can see which engine answered.

Sidecar ground-up rewrite — The Node.js sidecar has been rewritten for Agent SDK v0.2.72 with a new typed protocol (27 server events, 8 client messages), a permission handler for canUseTool routing, a pure event mapper for all 22 SDK message types, and a session registry with sequenced event emission. Resume URL and pipe deadlock bugs are fixed.

SSE-driven live data — The live monitor now receives session data via server-sent events instead of polling, eliminating stale-cache risks.

Persistent team browsing — Team composition and inbox messages are now reconstructed from JSONL files on disk when the in-memory store is cold. Teams survive server restarts without losing member or message history.

Evidence audit Phase 3 — Every release.sh run now verifies field coverage (6,874 paths) and detects phantom fields (struct fields with zero occurrences in real data) across all JSONL files as a pre-release gate.

Improvements

• Single-pass team summaries — JSONL reconstruction for team summaries now does one pass instead of multiple, reducing startup I/O.
• Search scope removed — The scope selector has been removed from the frontend; the backend handles scope internally for a cleaner interface.
• Session count accuracy — /api/search now returns a true total_sessions count rather than a capped estimate.

Getting started

npx claude-view@latest

New features

Zero-config sharing and auth — Supabase and relay URLs are now baked into the distributed binary at CI build time. npx claude-view@latest works with sharing and auth enabled out of the box — no env vars, no setup.

Self-hosting stays clean — Building from source (cargo build) produces a binary with no embedded URLs. Cloud features are opt-in: set SUPABASE_URL, SHARE_WORKER_URL, and SHARE_VIEWER_URL to enable them.

Improvements

• Self-hosting guide — README now explains the opt-in cloud features model clearly, with instructions for running fully local.
• Expanded feature docs — npx README reorganized into grouped sections covering all major features.

Getting started

npx claude-view@latest

New features

System Monitor page — A new sidebar section shows real-time CPU, memory, and disk usage for your machine alongside your Claude sessions. Open it to see live gauges and a top-process list, all streaming via server-sent events.

Animated gauges — Gauge values tween smoothly using a rAF-based animation hook. Values interpolate between readings instead of snapping, making CPU spikes and memory changes easy to track visually.

Live process list — Processes are grouped and normalized by name, sorted by CPU usage, and updated in real time. See what your machine is actually doing while your agents run.

Staggered card reveal — On first load, monitor cards animate in sequentially for a clean entry.

Improvements

• Async correctness — std::thread::sleep moved into spawn_blocking; the system observer no longer blocks the async runtime.
• SSE event alignment — init and snapshot event names now match between the Rust backend and the React frontend.

Getting started

npx claude-view@latest

New features

Workflow system — Create, browse, and run multi-stage workflows from a dedicated Workflows page. Each workflow has a VS Code-style detail layout with a Mermaid diagram preview, YAML editor, and a streaming LLM chat rail that generates workflow definitions in real time. The runner tab shows stage columns, attempt cards, and a progress bar. Two built-in seed workflows ship out of the box: Plan Polisher and Plan Executor.

Unified live chat — The live session view now combines history and real-time messages in a single scrollable conversation. No more switching between tabs to see what happened before you opened the session versus what’s happening now.

Recently closed sessions — When a session ends, it appears in a “Recently Closed” section on the Live Monitor instead of vanishing. Dismiss individual sessions or clear them all. Closed sessions persist across server restarts via SQLite.

Dynamic model list — The model selector now fetches available models from the backend instead of using a hardcoded list. Full model IDs are shown in tooltips for disambiguation.

Queued message indicators — User messages waiting in the queue appear as pending bubbles with a “Queued” badge, so you can see what’s been sent but not yet processed.

Improvements

• Workflow sidecar runner — Stage execution with gate polling and automatic crash recovery in the Node.js sidecar process.
• Queue operation metadata — System messages and queue operations now carry metadata through WebSocket events to the event cards.
• Production hardening — Six security and correctness fixes for the workflow endpoints.
• Live monitor polish — Resume button, consistent labels, batched SQLite writes, and FileEvent persistence.

Getting started

npx claude-view@latest

New features

Open in IDE — Files referenced in your Claude Code sessions now have a one-click button to open them directly in your editor. claude-view auto-detects VS Code, Cursor, Zed, and other installed editors. The button appears in the Changes tab, file headers, and Kanban project headers. Your preferred editor is remembered across sessions.

@File mention chips — When Claude references files during a session, the @filename mentions are extracted and shown as chips on session cards in both the Live Monitor and session history. Hover a chip to see the full path.

Agent SDK live chat upgrades — The live chat rail now renders thinking blocks, tool calls, and tool results with full syntax highlighting and collapsible sections. A mode selector lets you switch between Control and Review modes. A token usage gauge shows how much of the context window is in use.

Teams: members vs sub-agents — The team panel now clearly separates human team members from Claude sub-agents spawned during the session. The layout is cleaner and easier to scan at a glance.

Improvements

• teamName extraction fixed — Now correctly read from the top-level JSONL field instead of a phantom input.team_name path that never existed in real data.
• Branch metadata guard — Fixed a bug where apply_jsonl_metadata could overwrite an existing branch value with None.
• File history filenames — Resolved by content hash rather than backupFileName, which was unreliable for renamed files.
• Live monitor animation — Compacting card animation strengthened with border and glow pulse for clearer visual feedback.

Getting started

npx claude-view@latest

New features

Plugin Manager — A full GUI for browsing, installing, enabling, disabling, and uninstalling Claude Code plugins directly from the claude-view web UI. No terminal needed.

Plugin Card Grid — Each installed plugin renders as a card showing name, status, scope (user or project), and version. A health banner at the top shows plugin system status at a glance.

Marketplace Dialog — Browse available plugins and install them with a scope picker (user-level or project-level). Debounced search filtering across all plugin cards for instant discovery.

Plugin Actions — Right-click or use the action menu on any plugin card to enable, disable, or uninstall with a confirmation dialog. All actions correctly forward the scope parameter to the underlying CLI.

Improvements

• Full TUI data parity — Plugin cards now display the same data as claude plugin list terminal output (description, installed scope, enabled state, version).
• Server-side CLI caching — Plugin list output is cached with a 5-minute TTL (CachedUpstream pattern), so the page loads instantly on repeat visits.
• ANSI stripping — Raw CLI escape codes are stripped server-side before reaching the browser. No more garbled text in toast messages or error dialogs.
• Scoped mutations — Enable, disable, install, and uninstall all forward the correct scope parameter. Previously only install passed scope, leaving other actions broken for project-scoped plugins.
• Mobile: Expo SDK 55 compatibility — Updated react-native-screens (4.23.0), expo-router (55.0.4), platform-gated push notifications on web, cleaned up EAS build artifacts.
• Registry — New invocables_for_plugin method for querying plugin-specific invocable tools.

Getting started

npx claude-view

What’s next

• Plugin usage analytics (which plugins you use most, per-session breakdown)
• Mobile plugin management (view and toggle plugins from the Expo app)
• Plugin dependency graph visualization

Fixes

Project-scoped plugin actions — Fixed a bug where uninstalling, enabling, or disabling a project-scoped plugin failed silently because the CLI subprocess wasn’t given the correct working directory. The projectPath field is now wired end-to-end from the Rust backend through the API response, TypeScript types, React components, and back to the CLI subprocess as its CWD.

Update All for project plugins — The “Update All” button now correctly passes each plugin’s projectPath, so bulk updates work for project-scoped plugins that require CWD context.

Improvements

• E2E test suite for Plugins page — 26 Playwright tests covering API contract, search/filter, card interactions, action menu, health banner, marketplaces dialog, and keyboard accessibility. The Plugins page is now fully guarded against regressions.
• Scope flag forwarding — --scope is now only passed to the CLI for install and uninstall actions, matching the Claude CLI’s actual behavior. Enable/disable use auto-detection.

Getting started

npx claude-view@latest

What’s next

• Plugin usage analytics (which plugins you use most, per-session breakdown)
• Mobile plugin management (view and toggle plugins from the Expo app)
• Plugin dependency graph visualization

New features

Activity Page — calendar heatmap, project breakdown, daily timeline, and summary stats. See your Claude Code usage patterns at a glance.

Conversation Sharing — share any session via end-to-end encrypted link on share.claudeview.ai. Recipients view in-browser with zero setup. Your data is never readable by our servers.

Content-based Session Classification — sessions are automatically classified using SIMD pre-filter for fast, accurate categorization.

Kanban Swimlane View — organize sessions visually with drag-and-drop swimlanes.

Bulk Select & Archive — select multiple sessions and archive them in one action.

Hook Event Tracking — monitor Claude Code hook events (SessionStart, tool calls) directly in the dashboard.

Improvements

• Session topology and cwd resolution from JSONL — project paths are sandbox-proof
• CLAUDE_VIEW_DATA_DIR env var for sandbox and corporate environments
• Mobile app pivot from PWA to Expo/React Native (Tamagui v2)
• Unified pipeline with batch reliability fixes (fixes 1–6)
• Project path resolution no longer depends on encoded directory names

Getting started

npx claude-view

New features

Plan Tab — View Claude Code plans (.claude/plans/) directly in the session detail panel. Plans are parsed, indexed, and linked to sessions via slug. No more hunting through files.

Prompt History — Full-text search across all prompts you’ve sent to Claude Code. Browse by intent (feature, debug, refactor), see template usage patterns, and get statistics on prompt types. Includes Drain clustering for automatic template detection.

Teams Dashboard — Dedicated teams view showing team leads, inbox messages, team tasks, and file changes across team members. End-to-end team intelligence powered by ~/.claude/teams/ config files.

Unified Project & Branch Design Tokens — Consistent color and typography tokens for project names and branch labels across all views (live monitor, history, dashboard).

Improvements

• Agent tool support — Agent tool now extracts subagent_type like the legacy Task tool. Full parity with prompt history pipeline.
• Builtin tools registry sync — 5 missing tools (verify-before-completion, receiving-code-review, requesting-code-review, executing-plans, dispatching-parallel-agents) now in BUILTIN_TOOLS registry.
• File history paths — Resolve paths from hashes + improved diff UI for new/deleted files.
• OAuth cache timing — Server-driven cache control for usage pill updates.
• Phantom filter wiring — All prompt history filters now fully wired (display, paste, clipboard).

Getting started

npx claude-view

What’s next

• Mobile app enhancements (Expo SDK 56 upgrade)
• Custom session layouts (drag-and-drop column resizing)
• Codex historical + live verification protocols

New features

Mission Control — real-time dashboard for all running Claude Code agents. See status, cost, and current tool calls live.

Agent Control — approve/reject tool calls, send messages to agents (requires cloud relay).

Claude Code Plugin — @claude-view/plugin ships as a native Claude Code plugin with 8 read-only MCP tools, 3 skills (/session-recap, /daily-cost, /standup), and a SessionStart hook that auto-starts the dashboard. Install with claude plugin add @claude-view/plugin.

AI Fluency Score — composite 0–100 metric measuring AI collaboration effectiveness.

Improvements

• Full-text search now uses Tantivy for faster, more relevant results
• Cost tracking includes cache read/write breakdown
• Session browser shows model and git commit per session
• Performance: ~15MB binary with sub-second startup

Getting started

npx claude-view

New features

• Project renamed from vibe-recall to claude-view
• Hook events logging support
• Terminal view modes
• Context gauge auto-compact threshold marker

Improvements

• Full rebrand across all packages and documentation

Getting started

npx claude-view

New features

• Work Reports page with expandable session details
• Token breakdown and cost analysis
• Sessions survive server crashes — v2 snapshot format
• Live session cards show MCP servers and skills
• claude-view cleanup CLI command

Improvements

• CWD-based session discovery fixes

Getting started

npx claude-view

New features

• README rewrite with live monitoring focus

Improvements

• Fixed Live Monitor blank on first load (isInitialized flag)

Getting started

npx claude-view

New features

• Biggest release — live agent monitoring dashboard
• Sub-agent visualization with swim lanes and drill-down
• Rich tool rendering with verbose mode
• Unified SessionDetailPanel (Overview, Sub-Agents, Timeline, Cost)
• Tantivy full-text search, Cmd+K palette
• Cost tracking with tiered cache pricing
• AI Fluency Score (0-100)
• Smart Rules Engine

Improvements

• Major architecture overhaul for real-time monitoring

Getting started

npx claude-view

New features

• Multi-view support: Grid, List, Kanban, Monitor
• Live filtering by status, project, branch
• Keyboard navigation (j/k, 1-4, Enter, ?)
• Command palette (Cmd+K)

Improvements

• HTML export upgrade: dark/light toggle, metadata header, collapsible thinking blocks

Getting started

npx claude-view

New features

• No new features in this patch release

Improvements

• Bug fixes and stability improvements

Getting started

npx claude-view

New features

• Chat Insights & Pattern Discovery (Theme 4)
• Unified session detail API endpoints
• Git worktree session support with DB file_path fallback
• Resume button for quick session re-entry

Improvements

• Release script bumps all version sources

Getting started

npx claude-view

New features

• Live session monitoring dashboard
• Continue This Chat (Cmd+Shift+R) with context summary
• Unified Settings page (merged System status)
• Cold start UX with bandwidth-aware progress tracking

Improvements

• Streamlined navigation with consolidated settings

Getting started

npx claude-view

New features

• Time range filter with presets (today, 7d, 30d, 90d, all time)
• Heatmap tooltips and Git sync redesign with SSE
• AI generation breakdown with model usage distribution
• Storage overview with donut chart
• Project/branch filters

Improvements

• 65% fewer database round-trips (26 → 9 queries)
• 17 production-readiness fixes, epoch-zero guards
• 922+ tests (548 backend, 374+ frontend)

Getting started

npx claude-view

New features

• No new features in this patch release

Improvements

• Bug fixes and stability improvements following v0.4.0

Getting started

npx claude-view

New features

• Session discovery & navigation
• Git integration & AI contribution tracking

Improvements

• Improved session indexing and project detection

Getting started

npx claude-view

New features

• README “Why claude-view?” highlights section

Improvements

• Fix duplicate plugin entries in skill registry
• Cargo.toml version verification in release workflow

Getting started

npx claude-view

New features

• Full dark mode support
• Thread visualization
• Paginated messages API

Improvements

• Rusqlite write phase, typed struct dispatch, SIMD pre-filter, batch transactions, gzip compression
• Tail-first loading with infinite scroll

Getting started

npx claude-view

New features

• Thread visualization and paginated messages API
• Auto re-index on data changes
• ErrorBoundary for graceful error handling

Improvements

• ~8,000 lines changed across 98 files
• Performance: rusqlite, SIMD pre-filter, batch transactions, gzip, timing instrumentation
• Tail-first loading, infinite scroll, dark mode polish
• busy_timeout for database resilience
• Security hardening

Getting started

npx claude-view

New features

• Full JSONL parsing — all 7 message types rendered
• Compact/Full toggle, syntax-highlighted code blocks, dark mode
• Analytics dashboard — token/model tracking, metrics engine, git correlation
• Rust backend (Axum) ~15MB binary, parallel JSONL indexing with mmap + SIMD

Improvements

• SHA256 checksum verification, npm provenance attestation via Sigstore
• 4-platform CI builds

Getting started

npx claude-view

New features

• Semantic card components for conversation UI redesign

Improvements

• Hardening/security robustness across the application

Getting started

npx claude-view

New features

• Session browser with instant search and project grouping
• Rich conversation previews with syntax-highlighted code, rendered markdown, and HTML export
• Ships binaries for macOS (ARM & Intel), Linux x64, Windows x64
• Zero-config: npx claude-view opens at localhost:47892

Improvements

• First public release — foundational architecture established

Getting started

npx claude-view