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

# investigate

> Run a multi-agent investigation from a prompt, seed document, issue, or PR.

Run a multi-agent investigation. Agents take turns appending findings, evidence, and analysis to a shared findings document until quorum is reached.

```bash theme={null}
entire investigate [SEED_DOC] [flags]
entire investigate SUBCOMMAND
```

`entire investigate` is experimental and appears under labs while the workflow is still being refined.

## Inputs

Use one of these inputs:

| Input              | Description                                            |
| ------------------ | ------------------------------------------------------ |
| `SEED_DOC`         | Path to a starting findings file                       |
| `--issue-link URL` | GitHub issue or pull request URL resolved through `gh` |

When neither input is supplied and the multi-agent picker opens, the picker collects an investigation prompt that becomes the topic for the run.

## Flags

| Flag                     | Description                                                                                                       |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `--agents AGENTS`        | Override configured agents with a comma-separated list                                                            |
| `--max-turns N`          | Per-agent turn budget. Defaults to `2`.                                                                           |
| `--quorum N`             | Approvals needed to terminate. `0` means all agents.                                                              |
| `--continue RUN_ID`      | Resume an existing run                                                                                            |
| `--edit`                 | Re-open the investigate config picker                                                                             |
| `--findings`             | Browse local investigation manifests                                                                              |
| `--allow-untrusted-seed` | Required for non-interactive `--issue-link` investigations because the seed is attacker-influenced GitHub content |

## Subcommands

| Subcommand     | Description                                                       |
| -------------- | ----------------------------------------------------------------- |
| `show RUN_ID`  | Print a saved investigation's summary and findings                |
| `fix RUN_ID`   | Launch a coding agent with the run's findings as grounded context |
| `clean RUN_ID` | Delete a saved investigation                                      |
| `clean --all`  | Delete all saved investigation artifacts                          |

## Examples

```bash theme={null}
entire investigate leaderboard-route-investigation.md --max-turns 1
entire investigate --findings
entire investigate show RUN_ID
entire investigate fix RUN_ID
entire investigate clean RUN_ID
```

## Continue with

<CardGroup cols={2}>
  <Card title="Investigate Why Code Exists" icon="search-code" href="/learn/investigate-why-code-exists">
    Walk through a complete provenance investigation.
  </Card>

  <Card title="labs" icon="flask-conical" href="/cli-reference/labs">
    See experimental Entire workflows.
  </Card>
</CardGroup>