Buggazi + Cursor

Add bug tracking, feature planning, and sprint management to your Cursor workflow. 30 seconds.

Step 1: Set your API key

Add to your project's .env file:

CopyBUGGAZI_BASE_URL=https://buggazi.com
BUGGAZI_API_KEY=bgz_your_key_here

Step 2: Add to .cursorrules

Copy this into your project's .cursorrules file. Cursor reads it at session start and gains full Buggazi integration:

Copy# Buggazi Integration

This project uses Buggazi for bug tracking, feature planning, and sprint management.
API base: ${BUGGAZI_BASE_URL}. Auth: Bearer ${BUGGAZI_API_KEY}.

## When tests fail
POST /api/bugs with: title, severity (P0-P3), category (projectname-domain),
source ("e2e-test"), evidence.testOutput (error stack).

## When fixing bugs
GET /api/bugs?status=open to see open bugs.
PATCH /api/bugs/:bugId with: status ("fixing"), diagnosis.rootCause, diagnosis.affectedFiles[].
After fix verified: PATCH /api/bugs/:bugId/resolve with: resolution.fix, resolution.filesChanged[], resolution.commitSha.

## When planning features
POST /api/features with: title, priority (P0-P3), category, status ("todo"|"in-progress").
POST /api/features/:id/link-bug with: bugId (link related bugs).
GET /api/features/board for kanban view.

## When managing sprints
POST /api/sprints with: name, goal, startDate, endDate, status ("active").
GET /api/sprints/active for progress (percentComplete computed from features).

## Key patterns
- Bug IDs: BUG-YYYY-MMDD-NNN (auto-generated)
- Feature IDs: FEAT-YYYY-MMDD-NNN (auto-generated)
- Screenshots: send base64 PNG in evidence.screenshots[].data, CDN URL returned
- Status fields accept any string (no enum restriction)
- All requests need: -H "Authorization: Bearer ${BUGGAZI_API_KEY}" -H "Content-Type: application/json"

Step 3: Use it

Cursor now understands Buggazi. Try:

1. "Create a P1 bug for the login form returning 500"
2. "What open bugs do we have?"
3. "Resolve BUG-2026-0514-001 with commit abc123"
4. "Create a feature for SSO support and link it to BUG-001"
5. "What's our sprint progress?"

Full references

OpenAPI 3.1 Spec | Full Skill File | llms.txt | General Quickstart