> ## Documentation Index
> Fetch the complete documentation index at: https://cli-docs.relai.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# report

> Reference for relai report.

`relai report` sends a log file and feedback to RELAI so the team can review
a run — for a bug, a suggested improvement, or general feedback.

```sh theme={"system"}
relai report [OPTIONS]
```

## What gets sent

A report can include:

* the log file you select (or none, if you choose to submit feedback only).
* the feedback text you provide.
* minimal metadata: your OS, CPU architecture, and installed CLI version.

Nothing else is collected. `relai report` never scans your project for other
files, and it never includes credentials, API keys, or unrelated project
source — only the specific log file you pick and the feedback you type.

## Consent

`relai report` always shows a preview before anything leaves your machine —
the log file path and size, and the feedback text.

In interactive mode, you must confirm at a "Send this report to RELAI?"
prompt. Nothing is sent if you decline.

Pass `--yes` to skip the confirmation prompt and submit immediately.

## Options

| Flag                | Description                                                                                                                                                                                                           |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--log-file {PATH}` | Log file to include in the report. Optional — in interactive mode, omitting it opens a picker over `~/.relai/logs/` (with a skip option); in non-interactive mode, omitting it submits the report without a log file. |
| `--feedback {TEXT}` | Feedback for the RELAI team. Required in non-interactive mode; in interactive mode, omitting it prompts for it.                                                                                                       |
| `-y`, `--yes`       | Skip the review/confirmation prompt and submit immediately.                                                                                                                                                           |

## Examples

```sh theme={"system"}
relai report
relai report --feedback "{your feedback}" --yes
relai report --log-file ~/.relai/logs/{log-file}.jsonl --feedback "{your feedback}"
relai report --log-file ~/.relai/logs/{log-file}.jsonl --feedback "{your feedback}" --yes
```

## What to expect

* interactive runs show a picker of recent log files (from `~/.relai/logs/`,
  most recent first), with an option to skip and submit feedback only.
* a preview of the log file (if any) and feedback text, before the confirmation prompt.
* a printed report ID on success.

## Common failures

* the specified `--log-file` does not exist.
* empty feedback.
* feedback omitted in non-interactive mode.
* no RELAI API credentials configured (run `relai setup`).
* backend upload failure, or a log file over the size limit.