Bug Lab CLI
yanpaingkyaw/BugLab-cli
Converte bugs em casos verificados prontos para IA agir
Ver no GitHubAssistant de debugging orientado por evidências que transforma relatórios de bugs, logs e stack traces em pacotes de caso verificados e estruturados. Gera handoffs prontos para agentes IA ou desenvolvedores humanos agirem com segurança, mantendo privacidade de código e redação automática de secrets.
Instalação
npx convez-ai yanpaingkyaw/BugLab-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
- Estruturar relatórios de bugs desorganizados em documentação verificada
- Gerar planos de reprodução e root cause analysis automatizados
- Criar handoffs prontos para agentes IA (Claude, GPT-4) resolverem bugs
- Manter auditoria de debugging com evidências estruturadas em JSON
Veredito

Ferramenta especializada e bem-pensada para times que usam agentes IA em debugging. Diferencia-se ao criar pacotes verificados e auditáveis em vez de apenas gerar código. Curva de aprendizado moderada, retorno alto para fluxos de debugging em escala.
README
A tradução para o português deste README ainda está na fila.
Bug Lab CLI
Evidence-first debugging assistant that turns bug reports, logs, and stack traces into verified bug case bundles for developers and AI coding agents.
"From bug report to verified fix plan."
Installation
npm install -g buglab
Requires Node.js 20+.
Quick Start
# Initialize in your project
buglab init
# Set your OpenAI API key
export OPENAI_API_KEY=sk-...
# Analyze a bug report
buglab analyze --input bug-report.md
# Check status
buglab status
# Generate AI agent handoff
buglab handoff <case-id> --agent claude
Commands
| Command | Description |
|---|---|
buglab init | Create buglab.config.json and .buglab/ |
buglab analyze --input <file> | Analyze bug report, log, or stack trace |
buglab add-log <case-id> --file <file> | Attach logs to existing case |
buglab repro <case-id> [--run] | Plan or execute reproduction steps |
buglab handoff <case-id> [--agent] | Generate AI-agent-ready handoff |
buglab status [case-id] | Show case progress and confidence |
Output Bundle
Each analysis creates under .buglab/cases/<case-id>/:
00_summary.md — Human-readable bug summary
01_evidence.json — Machine-readable structured evidence
02_repro.md — Reproduction steps and commands
03_root_cause.md — Likely causes with confidence levels
04_fix_plan.md — Recommended implementation plan
05_verification.md — Tests, commands, and manual checks
06_agent_handoff.md — Prompt-ready handoff for AI agents
Configuration
buglab.config.json:
{
"version": 1,
"provider": "openai",
"models": {
"reasoning": "gpt-4o",
"summarization": "gpt-4o-mini"
},
"privacy": {
"sendCodeToProvider": false,
"sendLogsToProvider": true,
"redactSecrets": true
},
"commands": {
"allowRun": false,
"requireApproval": true
}
}
Privacy & Security
- Source code is not sent to providers by default
- Secrets are automatically redacted from evidence
- Commands require explicit approval before execution
- API keys are read from environment, never persisted to config
- All data stays local in
.buglab/
Supported Stacks
Detects: Node.js, TypeScript, React, Next.js, Express, Python, FastAPI, Laravel.
License
Apache-2.0