Agent Trajectory visualization and analysis platform
Project description
VibeLens
Agent trajectory visualization and analysis platform. Parses, normalizes, and visualizes conversation histories from coding agent CLIs using the ATIF v1.6 trajectory model.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b82b4d3f249d1fcdee50de432be9725678b7dd964018e5ee0a538c580bd85648
|
|
| MD5 |
5f22bd4bdbdfb6ae4bd7393838e9c14f
|
|
| BLAKE2b-256 |
110428462b40d68f3966601eab552bd407aeb0b23a276914c6a9e056a776fc62
|
Provenance
The following attestation bundles were made for vibelens-0.8.0.tar.gz:
Publisher:
publish.yml on yejh123/VibeLens
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vibelens-0.8.0.tar.gz -
Subject digest:
b82b4d3f249d1fcdee50de432be9725678b7dd964018e5ee0a538c580bd85648 - Sigstore transparency entry: 1155187147
- Sigstore integration time:
-
Permalink:
yejh123/VibeLens@abc34e896643faa685e209c29d92b45045f18b5e -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/yejh123
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@abc34e896643faa685e209c29d92b45045f18b5e -
Trigger Event:
push
-
Statement type:
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c2c168eccb4065cf2acb2a5ea612451ef7e1e6a9dc610c89f36b248d874e9762
|
|
| MD5 |
da6337756b0ff541b1968ed83171bdd9
|
|
| BLAKE2b-256 |
8495402e84824329c487b9c3b3cb89f4b5ab0ae0d920d8be3a0cc640651482d3
|
Provenance
The following attestation bundles were made for vibelens-0.8.0-py3-none-any.whl:
Publisher:
publish.yml on yejh123/VibeLens
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vibelens-0.8.0-py3-none-any.whl -
Subject digest:
c2c168eccb4065cf2acb2a5ea612451ef7e1e6a9dc610c89f36b248d874e9762 - Sigstore transparency entry: 1155187150
- Sigstore integration time:
-
Permalink:
yejh123/VibeLens@abc34e896643faa685e209c29d92b45045f18b5e -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/yejh123
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@abc34e896643faa685e209c29d92b45045f18b5e -
Trigger Event:
push
-
Statement type: