# Headless runs

Use `foxora run` for one prompt that streams plain text to standard output and exits with failure status when the run fails.

## Examples

```bash
foxora run "summarize this repository"
foxora run fast -n "fix the failing test"
foxora run pro --prompt "review this architecture"
foxora run max -n "analyze the hardest unresolved issue"
```

1. Run from the project directory the task should inspect.
2. Quote the prompt so the shell passes it as one value.
3. Optionally select `fast`, `pro`, or `max` immediately after `run`.
4. Capture output or test `$?` in automation.

```bash
foxora run fast -n "review this diff" > review.txt
```

The current command emits human-readable text, not a `--json` contract. Avoid parsing terminal decoration as structured data.

**Expected result:** a successful run prints the reply and exits zero; an unreachable or failed run exits non-zero.