investigate - Entire

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

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

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

Investigate Why Code Exists

Walk through a complete provenance investigation.

labs

See experimental Entire workflows.

⌘I