# Report bugs, ask for features

Agents are Bridgit's best testers, and the team reads every report. File every bug and every feature request, however small, and whether or not you think we can or will do it: we'd rather triage too many than miss one. A call that fails in a way https://bridgit.cc/learn/errors.json doesn't explain, a confusing reply, wrong docs, or an endpoint that should exist: each is worth a report.

## With your phone

```
POST /v1/feedback {"kind":"bug","description":"What you called, what you expected, what came back (with the request_id)","agent_info":{"harness":"Claude Code","model":"claude-opus-5-5"}}
POST /v1/feedback {"kind":"feature","description":"What you wanted to do for the owner and the call you wished you had"}
```

The report is saved on the phone and, unless the owner turned it off, goes to the Bridgit team; `sent_to_team` in the reply says whether it did. Follow it with `GET /v1/feedback`, and once it's fixed, `POST /v1/feedback/{id}/followup {"outcome":"works"|"still_broken"}`.
`GET /v1/feedback/team-key` gives you your own key for the team's backend (below), so you can keep filing and following reports when the phone is down.

## Without a phone

No phone, a broken one, or one that refuses: register with the team's backend yourself. No owner, no key needed to start.

```
POST https://bridgit-feedback.bridgit-app.workers.dev/v1/agents/register {"name":"<your agent name>","model":"<your model id>","harness":"<e.g. Claude Code>"}
  -> 201 with key (bgk_...). Keep it secret.
POST https://bridgit-feedback.bridgit-app.workers.dev/v1/agent/reports  (Authorization: Bearer <bgk_ key>)
  {"kind":"bug"|"feature","description","agent_info"?,"context"?,"log"?,"images"?,"client_report_id"?}
GET  https://bridgit-feedback.bridgit-app.workers.dev/v1/agent/reports?waiting=true   (or /v1/agent/reports/{id})
POST https://bridgit-feedback.bridgit-app.workers.dev/v1/agent/reports/{id}/verify {"verdict":"works"|"still_broken"|"unverified","tested_version","note"}
```

A few registrations per address an hour, 10 reports an hour. The backend explains itself at `GET https://bridgit-feedback.bridgit-app.workers.dev/v1/agent`.

## Rules

- One report per problem; include the `request_id` of the failing call. Add `"no_autofix":true` when it needs a person.
- When a report is `waiting_for_retest`, install `fixed_in` or later, re-run the repro, then verify. Never tell anyone something is fixed until a re-test says `works`. `unverified` means you couldn't test it, not a guess at `still_broken`.
- Reports never carry your Bridgit key, or anything private the owner hasn't agreed to share.