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

# gandalf report: render a markdown state report

> Render a markdown report of trust posture, evidence, findings, and blind spots for a snapshot or for current live state. Optional file output and JSON.

`gandalf report` renders a markdown report of Gandalf's evidence, audit findings, provenance, and trust posture. Pass a snapshot name to report on a saved state, or use the default `current` to snapshot live state on demand.

## Synopsis

```bash theme={null}
gandalf report [reference] [flags]
```

`[reference]` defaults to `current`. Any saved snapshot name is also valid.

## Flags

| Flag              | Description                                | Default                          |
| ----------------- | ------------------------------------------ | -------------------------------- |
| `--out`           | Write markdown to a file instead of stdout | (stdout)                         |
| `-p`, `--project` | Project directory                          | `.`                              |
| `--home`          | Home directory                             | `$HOME`                          |
| `--store`         | Gandalf store directory                    | `~/.gandalf` or `$GANDALF_STORE` |
| `--agent`         | Filter by agent                            | (unfiltered)                     |
| `--scope`         | Filter by scope                            | (unfiltered)                     |
| `--json`          | Emit a JSON envelope instead of markdown   | off                              |

## Examples

```bash theme={null}
gandalf report --project .
gandalf report baseline --project .
gandalf report current --project . --out gandalf-report.md
gandalf report baseline --project . --json
```

## Behavior

* With `current`, Gandalf captures live state, then renders the report.
* With a saved snapshot name, Gandalf loads the snapshot, captures current state, and includes a graph diff between them.
* `--out` writes markdown to the given path (mode `0644`).
* `--json` emits a structured envelope containing the source snapshot and the rendered markdown.

## Related

* [`gandalf snapshot`](/cli/snapshot)
* [`gandalf diff`](/cli/diff)