Buggazi + Windsurf

Project management for coding agents. As easy as git. 30 seconds to set up.

Step 1: Install + signup

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

Your API key is saved to .bgz/config.json in your project. The key is LIVE immediately 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.

Already have a key? Just run: bgz login --local --key YOUR_KEY

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

No --api-url needed. Defaults to buggazi.ai.

Step 2: Add to .windsurfrules

Add this to your project's .windsurfrules so Windsurf knows to use Buggazi:

Copy## Buggazi
This project uses Buggazi for bug tracking and feature planning.
Use the `bgz` CLI. Config is in .bgz/config.json (auto-loaded).
If not configured: bgz login --local --key YOUR_KEY

Run `bgz init --agent-schema` — it returns every command + valid flag.
That is the source of truth: if it is not in the schema, do not use it.

Step 3: Start using

Ask Windsurf to do anything — it discovers commands from bgz init --agent-schema and files bugs, features, and sprints automatically. Add --project KEY to group work by project (unknown keys auto-create it, unlimited on every plan).