convez.ai
AgenteProdutividadeIntermediário
CHATS-lab

VibeLens

CHATS-lab/VibeLens

Veja o que seus agentes IA estão fazendo. Analise e evolua.

Ver no GitHub
BomPluginScore · de 0 a 100

Agent para visualizar, analisar e otimizar sessões de agentes de IA de código. Oferece dashboard com replay de interações, insights de produtividade e gera ações CLAUDE.md prontas para melhorar seus agentes. Suporta Claude Code, Gemini, Codex e mais 8 agentes locais.

Instalação

$npx convez-ai CHATS-lab/VibeLens

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
21
Forks
2
Acompanhando
0
Saúde
37%
Último commit
há 1 mês
Versão
v1.0.8
Issues abertas
0
Contribuidores
4

Casos de uso

  • Visualizar e debugar fluxos de trabalho de agentes de código
  • Extrair insights de produtividade de sessões passadas
  • Gerar skills e ações reutilizáveis a partir de padrões recorrentes

Veredito

Ferramenta madura e bem documentada para quem trabalha com múltiplos agentes de IA. Dashboard intuitivo e suporte amplo a agentes locais tornam a análise de sessões acessível, mas requer familiaridade com linha de comando para setup inicial.

README

A tradução para o português deste README ainda está na fila.



VibeLens is an open-source tool that visualize and analyze your AI agent sessions. It reads your existing session logs, and supports 11 local agents out of the box (Claude Code, Codex, Gemini, Cursor, and more). Analyze every session, get paste-ready CLAUDE.md actions for productivity tips, and distill recurring workflows into reusable skills.

Just want a look? Try the live demo. Nothing to install.

Quick Start

Requirement: either uv (preferred) or Python 3.10+.

# macOS / Linux. Paste into Terminal.
curl -LsSf https://raw.githubusercontent.com/CHATS-lab/VibeLens/main/install.sh | sh
# Windows. Paste into PowerShell.
irm https://raw.githubusercontent.com/CHATS-lab/VibeLens/main/install.ps1 | iex

Have Python 3.10+:

pip install vibelens && vibelens serve

Have uv:

uv tool install vibelens && vibelens serve

Run without installing:

uvx vibelens serve

Prefer npm (Python also required):

npx @chats-lab/vibelens serve

Run vibelens serve to start it again.

VibeLens opens on http://localhost:12001 and your browser launches automatically.

Change the port with --port (for example, vibelens serve --port 8080). Press Ctrl+C to stop.

Full install guide and troubleshooting: docs/INSTALL.md.

Install uv (recommended, single binary, no Python needed):

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# or: brew install uv
# Windows
irm https://astral.sh/uv/install.ps1 | iex
# or: winget install --id=astral-sh.uv -e

Install or upgrade Python 3.10+ (alternative):

# macOS
brew install python@3.12

# Debian / Ubuntu
sudo apt update && sudo apt install -y python3 python3-pip

# Fedora / RHEL
sudo dnf install -y python3 python3-pip

# Arch
sudo pacman -S python python-pip
# Windows
winget install --id Python.Python.3.12 -e
# or: choco install python

Official downloads: python.org · uv docs

This happens when uv's tool bin directory isn't on your shell's PATH. The installer tries to fix this automatically, but the change only takes effect in new terminals.

Try one of:

  1. Open a new terminal and run vibelens serve again.
  2. Run the PATH fix manually, then reopen your terminal:
    uv tool update-shell
    
  3. Add it to PATH yourself (replace the path with what uv tool dir --bin prints):
    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc   # or ~/.bashrc
    source ~/.zshrc
    
  4. Skip the shim entirely and always use:
    uvx vibelens serve
    

Supported Agents

AgentFormatData Location
Claude CodeJSONL~/.claude/projects/
CodexJSONL + SQLite~/.codex/sessions/
Gemini CLIJSON~/.gemini/tmp/
CursorSQLite~/.cursor/chats/
Copilot CLIJSONL~/.copilot/session-state/
Kilo CodeSQLite~/.local/share/kilo/
KiroJSONL + JSON~/.kiro/sessions/
OpenCodeSQLite~/.local/share/opencode/
OpenClawJSONL~/.openclaw/agents/
HermesJSONL + SQLite~/.hermes/sessions/
CodeBuddyJSONL~/.codebuddy/projects/
Claude.ai (web)exported JSONdrag-and-drop upload

VibeLens auto-detects all your agent directories.

Screenshots

Session Visualization & Dashboard Analytics

Productivity Tips & Personalization

Developer setup

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

Uninstall

Match the command to how you installed:

# Installed with pip
pip uninstall vibelens

# Installed with uv (one-liner picked this path, or you ran `uv tool install`)
uv tool uninstall vibelens

# Installed globally via npm
npm uninstall -g @chats-lab/vibelens

VibeLens stores logs and cached data under ~/.vibelens/ and logs/ in the working directory. Remove them if you want a clean slate:

rm -rf ~/.vibelens

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.

How to donate?

  • Live demo: drag-and-drop a session file, preview it, then click Donate Data.
  • Local install: VibeLens auto-detects your existing sessions. Pick the ones you want to share, then click Donate Data.

Northeastern University researchers are recruiting active AI coding agent users for a paid study (~20 min, up to $100). See docs/HUMAN_STUDY.md for details.

Contributing

Contributions are welcome!

  1. New parsers: read docs/spec/parsers/add-parser-skill.md before writing code. Each existing parser's per-format spec lives alongside it in docs/spec/parsers/<agent>.md.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados