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

# Plan a scan and inspect results

> Preview which agents would run before you pay for a scan, then read or browse the results without another scan.

`agentgg recon` previews a scan. `agentgg status` and `agentgg view` read a finished one. None of the three re-runs detection.

## Preview with recon

`agentgg recon <path>` runs only the recon survey and the precondition plan. No agent reads a file for findings.

```bash theme={null}
agentgg recon ./src -o ./out
```

It writes `state/recon.json` and `state/plan.json` under `--output`, and prints which agents it would queue and why. A later `agentgg scan` against the same `--output` directory reuses this brief and plan instead of a second pass.

## Read the status

`agentgg status [output-dir]` reads a scan's `--output` directory and prints file counts, finding counts, verdicts, and recent runs. It defaults to `./scan-results`.

```bash theme={null}
agentgg status ./out
```

Pass `--json` for machine-readable output, for example to pipe into another tool.

```bash theme={null}
agentgg status ./out --json
```

## Browse the findings

`agentgg view [output-dir] [port]` starts a local web UI for one `--output` directory and opens it in your browser. The default port is 3737. Press Ctrl+C to stop it.

```bash theme={null}
agentgg view ./out
```

A busy port moves to the next free one. Pass a port explicitly to pick one yourself.

```bash theme={null}
agentgg view ./out 8080
```

## Boot the viewer right after a scan

Pass `--serve` to `agentgg scan` to start the same viewer as soon as the scan finishes, with no second command.

```bash theme={null}
agentgg scan ./src -o ./out --serve
```

`--serve` alone uses port 3737. `--serve 8080` picks the port.

Full flag list: [Scan flags](/cli/reference/scan-flags).