Skip to main content
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. 
echo "<message>" | clay feedback [--transcript-file <path>]

​
Flags

FlagDescription
--transcript-file <path>Attach a session transcript file (for example, an agent session transcript).

​
Output

{
  "ok": true,
  "includedTranscript": false,
  "environment": {
    "cliVersion": "0.1.12",
    "platform": "darwin",
    "arch": "arm64"
  }
}
FieldTypeDescription
oktrueAlways true on success.
includedTranscriptbooleanWhether a transcript was attached to the report.
transcriptErrorstring | undefinedSet only when a --transcript-file was given but could not be attached (missing, unreadable, or too large). The report is still sent.
environment.cliVersionstringVersion of the CLI that sent the report.
environment.platformstringOperating system platform.
environment.archstringCPU architecture.

​
Errors

CodeExitNotes
validation_error2The stdin message was empty or missing (nothing piped).
auth_required3Not signed in. Run clay login to authenticate.
rate_limited4Too many feedback reports in a short window. Retry after the delay in details.retryAfter.

​
Examples

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'