AgentXRay

Quick Start · Features · Screenshots · API · 中文

X-ray vision into your AI agent sessions. Supports OpenClaw, Codex, Claude Code, Hermes and OMP — all in one interface.

Features

• Multi-platform — Unified view across OpenClaw, Codex, Claude Code, Hermes and OMP sessions
• Session browser — Browse agents, filter/search sessions, view message history
• Tool call inspection — Expandable tool calls with arguments and results
• Trace view — Per-turn waterfall of where the time went: model inference (blue) vs tool execution (green, red on error); click any bar to jump to that message
• Prompt extraction — See every real human prompt per session (tool results, slash commands and injected noise filtered out), grouped by working directory, with search / JSON export / copy
• Prompt optimization — Cluster prompts into templates, attribute session outcomes (turns, tool calls, error rate) per template, and get Claude-powered rewrite suggestions via the local claude CLI
• Prompt library — Curate the prompts worth keeping into ~/.agentxray/library, tag / edit / search them, then install any of them as a native slash command for Claude Code, Codex or OMP with one click — $ARGUMENTS is passed through, so /name some args works in the target CLI
• Global search — One search box across all five platforms at once, multi-keyword AND matching, colored platform badges per hit — including prompts recovered from sessions that Claude Code's cleanup already deleted
• Session insights — Aggregate analytics dashboard with tool stats, error clustering and daily trends
• Spawn tracking — Detect and navigate parent/child agent relationships
• OMP sub-agents — Sub-agents spawned by an OMP session show up as chips in the summary; click one to read the child agent's full transcript
• Message timeline — Visual graph showing conversation flow with role indicators
• Resume command — One click copies the exact command to resume a session in its own CLI (codex resume, claude --resume, omp --resume=)
• Collapsible summary — Fold the session summary away when you want the full height for messages
• Auto-refresh — Live-updating session list and messages
• Settings panel — Configure platform directories from the UI, persisted in localStorage
• Session backup — Incremental archive of your session logs into ~/.agentxray/archive, one click in settings (also runs automatically, daily); unchanged files are skipped
• Keyboard navigation — Arrow keys to move between sessions

Screenshots

Session Browser

Browse agents and sessions in the sidebar. Each session card shows message counts by role (👤 User, 🤖 Assistant, 🔧 Tool) and spawn indicators. The main panel displays session metadata, token usage, and top tools at a glance.

Tool Call Inspection

Expand any tool call to see its arguments and result. Collapsed groups show tool type counts for quick scanning.

Spawn Tracking

Sessions that spawn sub-agents are marked with a 🔗 badge. Click to navigate the parent/child relationship chain.

Multi-Platform Support

Switch between OpenClaw, Codex, Claude Code, and Hermes with one click. Each platform's sessions are parsed from their native log format.

Settings

Configure platform directories from the UI. Changes are saved to localStorage — no server restart needed.

Quick Start

git clone https://github.com/alloevil/AgentXRay.git
cd AgentXRay
npm install
npm start

Open http://localhost:3800

Usage

Basic Workflow

1. Select a platform — Click OpenClaw, Codex, Claude Code, or Hermes in the top bar
2. Pick an agent — For OpenClaw, choose an agent from the dropdown (e.g. xiaot, mimo)
3. Browse sessions — Sessions are sorted by date, newest first. Each card shows:
   • Timestamp and status (active / archived)
   • Message counts: 👤 User, 🤖 Assistant, 🔧 Tool calls
   • 🔗 Spawn badge if the session spawned sub-agents
4. View messages — Click a session to load its full conversation
5. Inspect tool calls — Click any 🔧 tool_name button to expand arguments/results
6. Navigate spawns — Click the 🔗 link to jump to the spawned child session

Prompt View

Click the Prompts tab (next to Sessions / Insights) to see every real human prompt across all sessions, grouped by the session's working directory. Noise like tool results, slash-command echoes, system reminders and task notifications is filtered out.

• Preview & expand — Each session row shows a one-line preview of its first prompt; click to expand the full markdown-rendered prompt list
• Search — Filter prompts / directories / sessions live
• Export JSON — Download all extracted prompts for offline processing
• 分析优化 (Analyze) — Cluster prompts into templates, attribute session outcomes (avg turns, tool calls, error rate) per template, and get rewrite suggestions from Claude. Requires the claude CLI on the server's PATH; without it the clustering and attribution table still works
• 优化 (Optimize) — Hover any single prompt and click 优化 for an inline Claude-powered rewrite

Keyboard Shortcuts

Filtering & Search

• Search box — Filter sessions by ID or content
• Include archived — Toggle to show/hide archived (.reset.* / .deleted.*) sessions
• Auto-refresh — Automatically poll for new sessions and messages
• Auto-scroll — Scroll to the latest message when new content arrives

Configuration

Default directories

Custom directories

Via UI: Click the gear icon in the sidebar to set custom paths per platform. Saved to localStorage, no restart needed.

Via environment variables:

OPENCLAW_DIR=/custom/path/openclaw \
CODEX_DIR=/custom/path/codex \
CLAUDE_CODE_DIR=/custom/path/claude \
HERMES_DIR=/custom/path/hermes \
OMP_DIR=/custom/path/omp \
npm start

Via API: Pass ?dir=/absolute/path query parameter to any API endpoint.

API

All list/detail endpoints accept an optional ?dir= parameter to override the default directory.

Tech Stack

• Backend: Node.js + Express
• Frontend: Single-file HTML/CSS/JS (~70KB, no build step, no framework)
• Data: Reads JSONL session files directly from disk
• Zero external CDN — Everything is self-contained, works offline

Supported Log Formats

Archived sessions (.jsonl.reset.*, .jsonl.deleted.*) are also supported when "Include archived" is enabled.

License

MIT

_{⭐ Star this repo if you find it useful!}