Cline

Buggazi + Cline

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

Cline Cursor Cline Windsurf Aider

Step 1: Set your API key

Add to your project's .env file:

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

Step 2: Add to .clinerules

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

# 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

Cline 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?"
Cline reads .clinerules at the start of every session. The snippet above teaches it the full Buggazi API surface. No SDK or MCP server needed. Just plain instructions.

Full references

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