vibelens 0.9.16

Agent Trajectory visualization and analysis platform

VibeLens

See what your AI coding agents are actually doing.

Live Demo · Quick Start · PyPI · Changelog

---

Understand your agent. Teach it. Master it. — full blurb

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

• Session visualization. Step-by-step timeline with every tool call, thinking block, and sub-agent spawn.
• Dashboard analytics. Cost breakdowns by model, peak-hour histograms, and per-project drill-downs.
• Productivity tips. Flags retries, circular debugging, and abandoned approaches -- with suggested fixes.
• Skill personalization. Recommend, create, and evolve reusable agent skills from your session history.
• Session sharing. Share your interactions with your teammates with a link.

Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw out of the box.

pip install vibelens && vibelens serve

Session Viewer & Dashboard

Session Viewer Step-by-step timeline with tool calls, token counts, and sub-agent spawns.

Analytics Dashboard Aggregate stats, cost estimation, and usage trends over time.

Productivity Tips & Skill Personalization

Productivity Tips Detect friction patterns and get concrete improvement suggestions.	Skill Retrieval Match workflow patterns to pre-built skills from the catalog.
Skill Creation Generate new SKILL.md files from your session history.	Skill Evolution Evolve installed skills with targeted edits based on real usage.

Features

Feature	Description
Multi-agent parsing	Claude Code, Codex CLI, Gemini CLI, OpenClaw with auto-detection
Conversation Visualization	Tool calls, sub-agent spawns, elapsed time, image content
Dashboard Analytics	Cost breakdowns by model, peak-hour histograms, and per-project drill-downs.
Productivity tips	Friction detection, cross-session patterns, actionable mitigations
Skill personalization	Retrieve, create, and evolve reusable agent skills
Session sharing	Shareable URLs with read-only view

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

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/

Data Donation

VibeLens supports donating your agent conversation 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.

Development

# Lint and test
uv run ruff check src/ tests/
uv run pytest tests/ -v -s

# Frontend dev server (hot reload)
cd frontend && npm install && npm run dev

Contributing

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

License

MIT