CLI Reference

Install & authenticate

Initialize Buhg in your repository and paste your project's CLI token when prompted. The token is generated in Settings → CLI and is scoped to a single project.

$ npx buhg init

Start the fix loop

The main command pulls your project's open, triaged bugs into the terminal. From there your agent works each one following your BUHG.md conventions.

$ buhg:start
  Fetching open bugs...
  Found 3 open bugs.

  #4  Submit button unresponsive   high   open

Statuses

Bugs move through a small, fixed set of statuses so the dashboard and the terminal always agree:

• open — reported and triaged, not yet started
• in_progress — an agent or developer is working on it
• ready_for_review — a PR is open and waiting for review
• resolved — merged and closed out
• closed — closed without a fix (duplicate, wontfix)

Every status change from the terminal reflects in the realtime dashboard instantly — no refresh, no sync delay.