vibelens 0.9.30

Agent Trajectory visualization and analysis platform

VibeLens

See what your AI coding agents are actually doing.
Replay. Analyze. Evolve.

Live Demo · Quick Start · Supported Agents · PyPI · Changelog

---

Understand your agent. Teach it. Master it.

---

Your AI coding agents run hundreds of tool calls, burn thousands of tokens, and you have no idea what happened. VibeLens changes that.

pip install vibelens && vibelens serve

One install. Reads local logs. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw out of the box.

Features

Feature	Description
Session visualization	Step-by-step timeline with tool calls, thinking blocks, sub-agent spawns, and flow diagrams
Dashboard analytics	Usage heatmaps, cost breakdowns by model, peak-hour histograms, per-project drill-downs
Productivity tips	Spots retry loops, circular debugging, abandoned approaches across sessions
Personalization	Retrieve, customize, and evolve reusable skills from your real sessions
Session sharing	One-click shareable links for team review
Multi-agent support	Claude Code, Codex CLI, Gemini CLI, OpenClaw with auto-detection

Supported Agents

Agent	Format	Data Location
Claude Code	JSONL	~/.claude/projects/
Codex CLI	JSONL	~/.codex/sessions/
Gemini CLI	JSON	~/.gemini/tmp/
OpenClaw	JSONL	~/.openclaw/agents/

VibeLens auto-detects the agent format. Just point it at your session directory and it works.

Screenshots

Session Visualization & Dashboard Analytics

Session Visualization Step-by-step timeline with messages, tool calls, thinking blocks, and sub-agent spawns.

Dashboard Analytics Usage heatmaps, cost breakdowns by model, and per-project drill-downs.

Productivity Tips & Personalization

Productivity Tips Detect friction patterns and get concrete suggestions to improve your workflow.	Skill Recommendation Match workflow patterns to pre-built skills from the catalog.
Skill Customization Generate new SKILL.md files tailored to your session patterns.	Skill Evolution Evolve installed skills with targeted edits based on your real sessions.

Quick Start

Install and run

pip install vibelens
vibelens serve

Or run without installing:

uvx vibelens serve

VibeLens opens your browser and reads your local ~/.claude/ sessions by default.

Development install

git clone https://github.com/yejh123/VibeLens.git
cd VibeLens
uv sync --extra dev
uv run vibelens serve

Configuration

YAML-based configuration with environment variable overrides (VIBELENS_*). See config/vibelens.example.yaml for all options.

# Use a config file
vibelens serve --config config/self-use.yaml

# Override host/port
vibelens serve --host 0.0.0.0 --port 8080

Data Donation

VibeLens supports donating your agent session data to advance research on coding agent behavior. Donated sessions are collected by CHATS-Lab (Conversation, Human-AI Technology, and Safety Lab) at Northeastern University.

To donate, upload your data, select the sessions you want to share, and click the Donate button.

Contributing

Contributions are welcome! Please ensure code passes ruff check and pytest before submitting.

License

MIT