convez.ai
AgenteDesenvolvimento WebIntermediário
rewolf

Agent Session Browser

rewolf/agent-session-browser

Navegue e pesquise sessões de agentes de código localmente, sem envio de dados

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta local para navegar, buscar e filtrar sessões de agentes de IA (Cursor e Claude Code) no seu computador. Lê apenas arquivos locais, sem telemetria ou envio de dados para serviços externos. Inclui interface web e CLI para explorar transcrições, resumir sessões e retomar conversas.

Instalação

$npx convez-ai rewolf/agent-session-browser

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
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Buscar e filtrar histórico de conversas com agentes de IA por workspace ou data
  • Recuperar e resumir sessões de código anteriores para continuação rápida
  • Comparar múltiplas sessões de agentes (Cursor, Claude Code) em um único lugar

Veredito

Solução prática e focada em privacidade para quem usa intensivamente agentes de código. CLI scriptável e interface web bem estruturada tornam a ferramenta acessível tanto para consultas rápidas quanto para automação; cobertura local-only elimina preocupações de dados sensíveis.

README

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

Agent Session Browser

CI

Browse, search, and filter AI coding agent sessions on your machine — Cursor and Claude Code, with more providers pluggable later. Local files only; nothing is sent to external services.

Message search across agent transcripts with workspace sidebar and resume command

Message search: filter transcripts by text, date, and role; copy a resume command back to Cursor.

Why this exists: IDE and CLI history for agent conversations is hard to search, filter, and compare across workspaces. Agent Session Browser reads those transcripts locally and presents them in a web UI (and a thinner CLI) so you can find sessions quickly.

Features

  • Workspace tree — narrow sessions and search to a repo path in the sidebar
  • Session list — filter by name, dates, source (Cursor / Claude), and metadata; optional excerpt from the first user message
  • Message search — search transcript text across sessions with role and date filters
  • Conversation viewer — open the full thread in a modal (markdown, tool calls, find-in-conversation)
  • Resume commands — copy cd … && agent --resume=… (or Claude equivalent) from the UI
  • Also: scriptable CLI (asb) for lists, filters, and resume hints — see README.cli.md

Conversation modal with message history and in-thread search

Conversation viewer: read the full agent thread without leaving the browser.

Privacy: Reads session files from your machine only (~/.cursor/, ~/.claude/, and related paths). Session content and metadata are not transmitted to external services during normal use.

Quick start (web UI)

git clone https://github.com/rewolf/agent-session-browser.git
cd agent-session-browser
npm install
npm run install:all
npm run build
npm run dev

Open the URL Vite prints (default http://localhost:3846). The dev server proxies /api to the backend on port 3847.

packages/*/dist/ is not in git — run npm run build after pulling before starting locally.

CLI (optional): after build, node packages/cli/dist/index.js --help or see README.cli.md for asb usage.

Documentation

Configuration

CURSOR_USER_DIR overrides the default Cursor User data directory. When unset:

OSDefault
Linux / BSD / other Unix$XDG_CONFIG_HOME/Cursor/User if set, else ~/.config/Cursor/User
macOS~/Library/Application Support/Cursor/User
Windows%APPDATA%\Cursor\User (or ~\AppData\Roaming\Cursor\User if APPDATA is unset)

Agent transcript projects default to ~/.cursor/projects (ASB_CURSOR_PROJECTS_DIR to override). Claude paths and provider details are in session-sources.md.

Extending

To add a session provider (Amp, Codex, …), implement SessionProvider in @asb/core and register it in createDefaultProviders(). Hook reference, workspace.json layouts, and the readiness contract are documented in docs/technical/session-sources.md and 1310-provider-readiness.md.

npm / TLS / registry

.npmrc pins registry=https://registry.npmjs.org/ and strict-ssl=true. On corporate networks that intercept TLS, add your CA bundle:

cafile=/path/to/your-ca-bundle.pem

As a last resort only on your machine (do not commit): npm config set strict-ssl false, or strict-ssl=false in ~/.npmrc.

npm run install:all runs npm install inside each packages/* directory so npm discovers this .npmrc.

Ver o original no GitHub

Bom para

Relacionados