Disbug CLI & MCP Server
disbug-io/disbug-cli
Acesse relatórios de bugs do Disbug direto em agentes de IA
Ver no GitHubFerramenta Go que integra sessões de bug-report do Disbug com agentes de IA via MCP, permitindo inspecionar relatórios cloud ou locais. Funciona como CLI standalone ou como MCP server para Claude Desktop, Cursor e outros agentes de codificação.
Instalação
npx convez-ai disbug-io/disbug-cli1 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
Casos de uso
- Inspecionar relatórios de bugs detalhados em sessões de debugging
- Integrar histórico de erros com agentes de coding como Claude e Cursor
- Analisar logs, screenshots e network traces de relatórios locais ou cloud
- Automatizar triagem de bugs via MCP tools para IA agents
Veredito

Ferramenta especializada e bem estruturada para integrar debugging visual com agentes de IA. Excelente para times que usam Disbug e querem automação inteligente de triagem de bugs.
README
A tradução para o português deste README ainda está na fila.
disbug
Disbug CLI and MCP server for AI coding agents.
A single Go binary that reads bug-report sessions from your team's Disbug instance, plus downloaded local report JSON files. Use it from your terminal, or hook it into Claude Desktop / Claude Code / Codex / OpenClaw / Hermes / Cursor as an MCP server.
Install
macOS / Linux (Homebrew)
brew install disbug-io/tap/disbug
Windows (Scoop)
scoop bucket add disbug https://github.com/disbug-io/scoop-bucket
scoop install disbug
Direct download
Grab a binary for your OS/arch from Releases and put it on your PATH.
Quickstart
disbug login # opens a browser; saves token to <UserConfigDir>/disbug/default.json
disbug whoami # confirms identity + capabilities
disbug sessions --status open
disbug session https://app.disbug.io/acme/projects/2/sessions/5/
disbug pin 'https://app.disbug.io/acme/projects/2/sessions/5/?pin=1' --fields console,network
disbug inspect ./disbug-report-example.json
Inspect a downloaded local report
The Chrome extension can download a self-contained local report JSON when a user does not want to save a session to cloud. Inspect it without dumping screenshots or replay bytes into the terminal:
disbug inspect ./disbug-report-example.json
disbug inspect ./disbug-report-example.json --pin 2 --fields console,network
disbug inspect ./disbug-report-example.json --pin 2 --fields screenshot,replay
screenshot and replay fields are decoded to local cache file paths only when requested. The default summary prints pin feedback, URLs, artifact availability, and log counts.
Use as an MCP server
Disbug exposes read-only MCP tools for cloud reports: whoami, list_sessions, get_session, get_pin, get_pins, search_sessions, and search_pins.
For downloaded local report JSON files, use inspect_local_report with a filesystem path. It returns the same lightweight summary as disbug inspect, and can inspect a single pin with selected fields without needing native host setup or a cloud upload.
Agent setup recipes:
Multi-profile
disbug --profile work login
disbug --profile personal login
In the agent config, add the binary twice with args: ["--profile", "work", "mcp"] etc.
Exit codes
| Code | Meaning |
|---|---|
| 0 | OK |
| 2 | Usage error (bad ref, bad flag) |
| 4 | Auth error (no token, 401) |
| 5 | Network unreachable |
| 6 | Not found (404) |
| 7 | Forbidden (403, including free-tier locked) |
| 8 | Rate limited (429) |
| 9 | Server error (5xx) |
Development
make install-hooks
make ci
The pre-commit hook runs make fmt-check and make lint.
License
MIT - see LICENSE.