> ## Documentation Index
> Fetch the complete documentation index at: https://developers.clay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# feedback

> Send a bug report or feedback to the Clay team from the CLI.

Send a bug report or product feedback to the Clay team. The message is read from standard input, and the CLI attaches environment details (CLI version and platform) automatically. Optionally attach a session transcript with `--transcript-file`.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
echo "<message>" | clay feedback [--transcript-file <path>]
```

## Flags

| Flag                       | Description                                                                  |
| -------------------------- | ---------------------------------------------------------------------------- |
| `--transcript-file <path>` | Attach a session transcript file (for example, an agent session transcript). |

## Output

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "ok": true,
  "includedTranscript": false,
  "environment": {
    "cliVersion": "0.1.12",
    "platform": "darwin",
    "arch": "arm64"
  }
}
```

| Field                    | Type                | Description                                                                                                                            |
| ------------------------ | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `ok`                     | true                | Always `true` on success.                                                                                                              |
| `includedTranscript`     | boolean             | Whether a transcript was attached to the report.                                                                                       |
| `transcriptError`        | string \| undefined | Set only when a `--transcript-file` was given but could not be attached (missing, unreadable, or too large). The report is still sent. |
| `environment.cliVersion` | string              | Version of the CLI that sent the report.                                                                                               |
| `environment.platform`   | string              | Operating system platform.                                                                                                             |
| `environment.arch`       | string              | CPU architecture.                                                                                                                      |

## Errors

| Code               | Exit | Notes                                                                                       |
| ------------------ | ---- | ------------------------------------------------------------------------------------------- |
| `validation_error` | 2    | The stdin message was empty or missing (nothing piped).                                     |
| `auth_required`    | 3    | Not signed in. Run [`clay login`](/cli/reference/login) to authenticate.                    |
| `rate_limited`     | 4    | Too many feedback reports in a short window. Retry after the delay in `details.retryAfter`. |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
echo "search returns no results for valid query" | clay feedback
echo "see attached log" | clay feedback --transcript-file ./session.jsonl
echo "repro attached" | clay feedback | jq -e '.ok'
```