# ox feedback (https://sageox.ai/docs/cli/feedback)

# ox feedback

If the ox CLI confused you, failed you, or cost you tokens, tell SageOx Support with `ox feedback`. It sends a private report from a file or stdin. It does not create a public GitHub issue.

## Usage

<Terminal>
  <TerminalCommand>ox feedback --file &lt;path|-&gt; [flags]</TerminalCommand>
</Terminal>

## Write a report

- **Title:** the first line of the report is its title, 8–200 characters.
- **Size:** a report must fit within 4 KiB and 4,000 characters.
- **Source:** pass a file path to `--file`, or `-` to read the report from stdin.

## What the ox CLI sends

The ox CLI sends only your report, the optional reply email, your ox version, and your OS and architecture. It collects no logs, environment variables, or session content automatically. Explicit feedback works with telemetry off.

The ox CLI refuses a report that contains possible secrets before anything leaves your machine. Sending also requires current secret checks. `--dry-run` works offline and prints the exact JSON body without sending it.

## Choose a reply address

| You run | Reply address |
|---------|---------------|
| Signed in, no `--email` | Your signed-in account's notification address |
| `--email <address>` | That address; the ox CLI does not use your login |
| `--anonymous` | None; the ox CLI skips login explicitly |
| Not signed in, no `--email` | None |

## Examples

<Terminal>
  <TerminalComment>Check a bug report locally and print the exact JSON body, without sending</TerminalComment>
  <TerminalCommand>ox feedback --type bug --file report.txt --dry-run</TerminalCommand>
</Terminal>

Run this first to see exactly what SageOx Support would receive. It works offline.

<Terminal>
  <TerminalComment>Send the bug report and print the result as JSON</TerminalComment>
  <TerminalCommand>ox feedback --type bug --file report.txt --json</TerminalCommand>
</Terminal>

<Terminal>
  <TerminalComment>Read the report from stdin and give a reply address without login</TerminalComment>
  <TerminalCommand>cat report.txt | ox feedback --file - --email person@test.sageox.ai</TerminalCommand>
</Terminal>

## Flags

| Flag | Description |
|------|-------------|
| `--file` | Report file, or `-` to read stdin. Required |
| `--type` | Report category: `bug`, `feature-request`, or `feedback` |
| `--email` | Submit without login, using this reply address |
| `--anonymous` | Submit without using login or supplying a reply address |
| `--dry-run` | Print the locally checked JSON body without sending |

## What's next

- [ox doctor](/docs/cli/doctor) - Run diagnostics on your ox installation and configuration
- [ox version](/docs/cli/version) - Print the ox version that your report includes
- [FAQ](/docs/faq) - Answers to common questions about setup and data