jwmossmoz/bugzilla

Bugzilla CLI

Requires: export BUGZILLA_API_KEY="your-key" (get from https://bugzilla.mozilla.org/userprefs.cgi?tab=apikey)

Read-only ops work without auth.

Run via the installed skill path:

BZ=~/.claude/skills/bugzilla/scripts/bz.py

Usage

uv run "$BZ" <command> [options]

Run uv run "$BZ" --help for full options.

Commands

| Command | Purpose | |---------|---------| | search | Find bugs by product, component, status, assignee, etc. | | get | View bug details, comments, history | | create | File a new bug (requires: product, component, summary, version) | | update | Modify status, assignee, priority, add comments | | comment | Add comment to a bug | | attachment | Attach files to a bug | | needinfo | Request or clear needinfo flags | | products | List products and components | | whoami | Verify authentication | | create-image-regression | File a bug for a confirmed image regression |

Quick Examples

# Search
uv run "$BZ" search --quicksearch "crash" --limit 10
uv run "$BZ" search --product Firefox --status NEW,ASSIGNED --priority P1

# View
uv run "$BZ" get 1234567 -v --include-comments
uv run "$BZ" get 1234567 --include-comments --full-comments
uv run "$BZ" get 1234567 --include-comments --include-history --format json

# Update
uv run "$BZ" update 1234567 --status RESOLVED --resolution FIXED
uv run "$BZ" needinfo 1234567 --request [email protected]

# Create
uv run "$BZ" create --product Firefox --component General --summary "Title" --version unspecified

Image Regression Template

Create a pre-filled bug for confirmed image regressions:

# Basic usage
uv run bz.py create-image-regression \
  --image-version 1.0.9 \
  --worker-pool gecko-t/win11-64-24h2-alpha

# Full example with investigation details
uv run bz.py create-image-regression \
  --image-version 1.0.9 \
  --worker-pool gecko-t/win11-64-24h2-alpha \
  --windows-build 26100.7171 \
  --production-version 1.0.8 \
  --failing-tests "test_keycodes.xhtml,mochitest-browser-media" \
  --investigation-doc ~/moz_artifacts/win11-24h2-image-1.0.9-failure-investigation.md \
  --task-group U0vOaaW-T-i5nN79edugYA

# Dry run to preview
uv run bz.py create-image-regression \
  --image-version 1.0.9 \
  --worker-pool gecko-t/win11-64-24h2-alpha \
  --dry-run

Default Fields

| Field | Default Value | |-------|---------------| | Product | Infrastructure & Release Engineering | | Component | General | | Severity | S3 | | Priority | P3 | | Keywords | regression |

Gotchas

• Read-only ops (search, get, whoami, products) work without BUGZILLA_API_KEY; write ops (create, update, comment, attachment, needinfo, create-image-regression) need it.
• --quicksearch only honors what BMO's quicksearch grammar supports. For structured filters use --product, --component, --status, --priority.
• create requires --product, --component, --summary, and --version together — missing any of them produces a confusing 400, not a useful error.

References

• examples.md - Workflow examples and user request mappings
• api-reference.md - REST API endpoints and fields
• Implementation: scripts/bz.py