Skip to content

v0.1.1 - First public release

Choose a tag to compare

View all tags
@moraxh moraxh released this 22 Sep 19:06
· 12 commits to main since this release
v0.1.1
d17fa1b

Buggo's first public release: an AI-native bug investigator that scans a repository and ranks the files most likely responsible for a reported bug, using Jev as a cheap decision layer.

Install

npm install -g @moraxh/buggo
buggo config set-key <your-openrouter-key>
buggo investigate "checkout fails when cart is empty" --repo /path/to/your/repo

Also on npm: @moraxh/buggo (the installed command is buggo; the bare package name was already taken).

What it does

  • Scans a repo's production source files (JS/TS/JSX/TSX/Python, plus YAML/TOML/Dockerfile config files) and extracts structural signal via tree-sitter - never full file contents.
  • Ranks candidate files with Jev, chunked so large repos (1000+ files) get every candidate a real judgment instead of a heuristic pre-filter dropping most of the codebase.
  • Extra context that feeds ranking as observed evidence: --diff <ref>, --recent-changes <n>, stack trace path matching, git recency, and --exclude <file> to re-run cheaper after ruling out a suspect.
  • Human CLI (live, Ink-rendered detective view), --format json for agents, and an MCP server (buggo_investigate) with a per-session investigation cap.

Benchmarked

80% Top-1 / 91% Top-5 on 100 held-out real-world bugs (BugsJS), never seen while building the pipeline. Full numbers in the README.

What it doesn't do (yet)

buggo hunt (blind bug discovery), reproduction, and patching are not implemented - v0.1 stops at localization.

Assets 2
Loading