# Report a gap or bug

> Send the Glassly team a missing feature, bug, or docs/source mismatch with one command. Works for people and coding agents, no sign-in needed.

Source: https://docs.dev.glassly.ai/app-devs/reference/feedback/

Hit something missing or wrong? A missing simulator, an API that behaves
differently from these docs, a confusing error? Report it instead of working
around it quietly. Every report reaches the Glassly team.

```bash
glassly feedback "No simulator for the R1 ring, so ring input can't be tested locally"
```

The CLI prints a report id such as `rep_01K...`. Mention it if you follow up on
the same issue.

**Coding agents:** when you find a gap in the Glassly Miniapp SDK, the CLI, or
these docs, run `glassly feedback` with a short description of what you
expected, what happened, and where (docs URL, API name, or file). Then carry on
with your workaround. No sign-in is needed.

## What gets sent

Your text, plus details the CLI collects for you:

| Field | Source |
|---|---|
| Miniapp package name | `packageName` from the nearest `miniapp.json` (override with `--package`) |
| CLI version | `@glassly/cli` |
| Build tooling version | `@glassly/miniapp-cli` |
| SDK version | `@glassly/miniapp` installed in the project |
| Runtime | OS, CPU architecture, Bun version |

If you are signed in (`glassly login`, or `CLI_TOKEN` set to an API key), the
report also carries your developer account and org so the team can reply.
Otherwise it is anonymous. Nothing else from your project is sent: no source,
no `.env`, no logs.

## Options

```bash
glassly feedback "<text>"                     # send a report
git diff | glassly feedback                   # read the text from stdin
glassly feedback --package com.acme.app "..." # name the package explicitly
glassly feedback --dry-run "..."              # print what would be sent, send nothing
glassly feedback --json "..."                 # print {"reportId", "anonymous"}
```

## Without the CLI

`glassly feedback` is a thin wrapper over one HTTP call. Anything that can make
a request can file the same report:

```bash
curl -X POST https://core.glassly.ai/api/developer/feedback \
  -H 'content-type: application/json' \
  -d '{"message": "Docs say session.ring exists, the SDK has no such field", "context": {"packageName": "com.acme.app"}}'
```

| Field | Type | |
|---|---|---|
| `message` | string, 1–8000 characters | Required. What is missing or wrong. |
| `context` | object | Optional. Any extra detail: versions, package name, docs URL. |

Add `Authorization: Bearer <token>` with a Developer Console API key to attach
your account. The response is `201 {"reportId": "rep_..."}`. Each IP can send
20 reports an hour.

## Other channels

- Talk to the team and other developers on [Discord](https://glassly.ai/discord).
- Account, org, and publishing questions belong in the
  [Developer Console](https://console.glassly.ai).
