VibeLens

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

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

---

Let your agent know you better!

---

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, and sub-agents
Dashboard analytics	Usage heatmaps, cost breakdowns, and per-project stats
Productivity tips	Detects recurring frustration patterns and suggests concrete fixes
Personalization	Retrieve, customize, and evolve reusable skills from your real sessions
Session sharing	Share sessions via one-click links
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