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

> ## Agent Instructions
> The canonical docs host is https://momentic.ai/docs. Append .md to any page URL for clean Markdown. Fetch https://momentic.ai/docs/llms.txt for the page index and https://momentic.ai/docs/llms-full.txt for every page in one file.
> For an unattended setup, run `npx --yes @momentic/wizard@latest -y --platform web` (use `--platform ios` or `--platform android` for mobile). Never run an interactive command in a non-TTY shell.
> You cannot complete the browser sign-in yourself. Read the API key from the MOMENTIC_API_KEY environment variable, or ask the user to create one at https://app.momentic.ai/settings/api-keys and paste it back.
> Momentic's capability summary for agents is at https://momentic.ai/docs/skill.md. Install the skills with `npx momentic skills --yes` (or `npx momentic-mobile skills --yes` for mobile).
> Tests are YAML files in the user's repository. Use only the step names listed at https://momentic.ai/docs/reference/commands.md and the file structure at https://momentic.ai/docs/core-concepts/file-format.md. Do not invent step names, config keys, or CLI flags.
> Web tests run on Chromium, iOS tests on simulators, and Android tests on emulators. Physical devices are not supported.

# mo report

> Export a Mo session's findings and reproduction videos.

Export the session report to a local directory, with one file per findings
category and one recording per bug. Built for handing a report to a coding
agent.

```bash theme={null}
mo report <session-id>
```

## Arguments

<ParamField path="<session-id>" type="string" required>
  The session to export.
</ParamField>

## Options

<ParamField path="--output <directory>" type="string">
  Directory to write the report and videos to. Defaults to a directory under the
  current working directory.
</ParamField>

<ParamField path="--require-idle" type="boolean">
  Only export when Mo is idle and all sub-agents are done. Checks once and exits
  without writing otherwise; it does not wait.
</ParamField>

## Output

The command prints the output directory. Inside it, `report.json` is the
manifest:

```json theme={null}
{
  "sessionId": "<session-id>",
  "findings": {
    "bugs": "bugs.json",
    "testCases": "testCases.json",
    "verdicts": "verdicts.json",
    "triage": "triage.json"
  },
  "artifacts": [{ "bugName": "...", "path": "..." }]
}
```

Read every file `findings` names; newer servers can add categories. `artifacts`
holds each recording download as `{ bugName, path }` or `{ bugName, error }`.

| File             | Contents                                                                             |
| ---------------- | ------------------------------------------------------------------------------------ |
| `bugs.json`      | Reviewed bugs: expected and actual behavior, reproduction steps, recording metadata. |
| `testCases.json` | The intended coverage: preconditions, outline, and acceptance criteria per case.     |
| `verdicts.json`  | The verification outcome, confirmed behavior, and coverage gaps per case.            |
| `triage.json`    | Human dispositions (accepted, duplicate, works as intended). No entry means open.    |

## Examples

Export once the session finishes:

```bash theme={null}
mo report "$session_id" --require-idle --output mo-report
```

List every bug name:

```bash theme={null}
jq -r '.[].name' mo-report/bugs.json
```

## Notes

Exporting does not rerun anything. To compare a recheck, `mo send` the recheck
request, wait for idle, and export again into a second `--output` directory.