Agent V

A local-first workspace for ingesting, normalizing, and visualizing session artifacts from multiple AI coding agents.

Agent V provides a unified view of interactions with AI coding assistants like Claude Code, Codex CLI, and OpenCode, allowing you to search across sessions, analyze tool usage, and visualize agent timelines.

Key Features

• Multi-Agent Ingestion: Adapters for discovering and parsing session data from:
  • Claude Code: JSONL sessions from ~/.claude/projects/
  • Codex CLI: Rollout logs from ~/.codex/sessions/
  • OpenCode: Session exports and logs via opencode CLI
  • Crush: SQLite database ingestion with schema probing
• Unified Data Model: All agent events are normalized into a canonical format (Messages, Tool Calls, Results, Errors, System Events) while preserving raw payloads for debugging.
• High-Performance Search: Full-text search (FTS5) across all session titles and message content.
• Dual Interfaces:
  • CLI: Powerful command-line tool for batch ingestion, searching, and statistics.
  • Desktop App: Modern, cross-platform interface built with Tauri 2.x and Svelte 5.
• Local-First: Your data stays on your machine in a local SQLite database.

Stack

Backend	Database	Frontend	CLI
Rust 2024 (Workspace)	SQLite + FTS5	Svelte (TS) + Tauri, Tailwind	Clap

Getting Started (Development)

Prerequisites

• Rust (latest stable)
• Node.js & pnpm (for desktop app)

CLI

The CLI provides powerful command-line access to all Agent V functionality.

Build:

cargo build -p agent-v-cli

Available Commands:

agent-v doctor                                # System health check
agent-v ingest [--source <name>]              # Ingest sessions (all sources or specific)
agent-v ingest --watch                        # Continuously watch for new sessions
agent-v list sessions [--source <name>]       # List all sessions
agent-v show session <id>                     # Show session details with events
agent-v search <query>  [--source <name>]     # Search with FTS5
                        [--since <duration>]
                        [--kind <type>]
agent-v stats [--by <dimension>]              # Analytics and statistics
              [--since <duration>]
agent-v export --session <id>                 # Export session
              [--format md|json|jsonl]

Desktop Development

Start the desktop application in development mode:

just dev              # Run Tauri desktop app

Or using pnpm directly:

pnpm tauri dev

Project Structure

crates/
├── core/         # Canonical data models and shared types
├── adapters/     # Per-tool adapters for parsing different sources
├── store/        # SQLite schema, migrations, and FTS5 search
├── ingest/       # File scanning and incremental ingestion logic
├── api/          # Tauri command handlers (Rust <-> Frontend bridge)
└── cli/          # Command-line interface implementation
apps/
├── desktop/      # Svelte + Tauri desktop wrapper
└── worker/       # Cloudflare Worker for auto-updates

References

• Inspired by claude-code-viewer.
• Designed to work with Claude Code, Codex, and OpenCode.