Skip to main content

Agent Trajectory visualization and analysis platform

Project description

VibeLens

PyPI version Python 3.12+ License: MIT

Agent trajectory visualization and analysis platform. Parses, normalizes, and visualizes conversation histories from coding agent CLIs using the ATIF v1.6 trajectory model.

Session list with step timeline

Session detail with sub-agent view

Live Demo: vibelens.chats-lab.org

Features

  • Multi-agent parsing — Claude Code, Codex CLI, Gemini CLI, and Dataclaw formats with auto-detection
  • Step timeline — Visual timeline with elapsed time, tool call details, and sub-agent spawn indicators

Quick Start

Install and run

pip install vibelens
vibelens serve

Or run without installing:

uvx vibelens serve

VibeLens opens your browser automatically and reads your local ~/.claude/ sessions by default. Use --no-open to disable the browser auto-open.

Development install

git clone https://github.com/yejh123/VibeLens.git
cd VibeLens
uv sync
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 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.

We welcome contributions of real-world coding agent trajectories across all supported formats. Your data helps the research community better understand how developers interact with AI coding assistants.

To donate, upload your data, select the sessions you want to donate, 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vibelens-0.8.0.tar.gz (4.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vibelens-0.8.0-py3-none-any.whl (1.1 MB view details)

Uploaded Python 3

File details

Details for the file vibelens-0.8.0.tar.gz.

File metadata

  • Download URL: vibelens-0.8.0.tar.gz
  • Upload date:
  • Size: 4.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for vibelens-0.8.0.tar.gz
Algorithm Hash digest
SHA256 b82b4d3f249d1fcdee50de432be9725678b7dd964018e5ee0a538c580bd85648
MD5 5f22bd4bdbdfb6ae4bd7393838e9c14f
BLAKE2b-256 110428462b40d68f3966601eab552bd407aeb0b23a276914c6a9e056a776fc62

See more details on using hashes here.

Provenance

The following attestation bundles were made for vibelens-0.8.0.tar.gz:

Publisher: publish.yml on yejh123/VibeLens

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vibelens-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: vibelens-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for vibelens-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c2c168eccb4065cf2acb2a5ea612451ef7e1e6a9dc610c89f36b248d874e9762
MD5 da6337756b0ff541b1968ed83171bdd9
BLAKE2b-256 8495402e84824329c487b9c3b3cb89f4b5ab0ae0d920d8be3a0cc640651482d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for vibelens-0.8.0-py3-none-any.whl:

Publisher: publish.yml on yejh123/VibeLens

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page