Quickstart: bgz CLI

Project management for coding agents. As easy as git. Get running in 60 seconds.

Claude Code

Cursor

Cline

Windsurf

Aider

Codex

Copilot

Claude Web

Raycast

1

Install + signup

npm install -g buggazi
bgz signup my-project --local

Your agent gets an API key that is LIVE instantly with full access for 48h - start filing bugs and features right away, no card or email needed up front. Before the window closes, your human opens the trial link ($0 card-auth) to start the free 7-day trial; the same key keeps working and your data is preserved, no re-signup.

Referred by a Buggazi user? Add --ref BGZ-REF-XXXX to signup: 14-day trial instead of 7.

2

File your first bug

bgz bug "Login form returns 500" -s P1

# Output:
# ✓ Created BUG-2026-0608-001: Login form returns 500
3

Plan a feature

bgz feature "SSO support" -p P1

# ✓ Created FEAT-2026-0608-0001: SSO support
4

See your project

bgz snapshot

# Buggazi Snapshot (my-project)
# ════════════════════════════
#   1 features  1 open bugs  0 sprints  0 contracts
#
# Features
# ───────────
#   backlog (1)
#   ├─ FEAT-2026-0608-0001 P1 SSO support
#
# Open Bugs
# ───────────
#   P1 (1)
#   ├─ BUG-2026-0608-001 reported Login form returns 500

Resolve a bug

bgz fix BUG-2026-0608-001 -c a3f2c1d -f "Added null check in auth handler"

# ✓ Resolved BUG-2026-0608-001

Create a sprint

bgz sprint create "Sprint 1"

bgz sprint
# Sprint 1  active  ░░░░░░░░░░ 0%  0/1 features

Group by project

bgz bug "Checkout 500" -s P1 --project shop-api
# unknown keys auto-create the project

bgz projects
# shop-api  active  1 bugs  0 features  0 sprints

bgz project show shop-api
# everything in one project: bugs, features, sprints, custom fields

Pass --project KEY on bugs, features and sprints. Projects are unlimited on every plan and support custom fields via bgz project update KEY --field team=platform.

Invite a human tester

bgz project invite shop-api --email tester@acme.com
# single-use email invite, scoped to just this project

bgz project invite shop-api --link --expires 7d
# shareable link, multi-use, passwordless join

bgz sprint invite SPRINT-ID --link
# scope a tester to one sprint instead

Testers are free and never use a seat. They see only their scoped board, file bugs and comment. List them with bgz testers; revoke with bgz tester revoke <id|token>.

Full command reference

bgz --help

Or see llms.txt for the complete reference.

tAI

Hi! I'm τAI

I can help with bug tracking, feature planning, sprint management, pricing, or setting up a new project. What can I help you with?

tAI is thinking...