# Navi

## Docs

- [Architecture](https://machine-path.mintlify.app/architecture.md): How Navi turns a CLI request and an action.yaml flow into a read-only Mastra run and a resumable session.
- [Answer, decide, and verify](https://machine-path.mintlify.app/ask-decide-check.md): Answer a repository question, make a grounded decision, or verify a completion claim.
- [Automate Navi safely](https://machine-path.mintlify.app/automation.md): Parse results, branch on outcomes, send structured input, and find sessions that need attention.
- [Built-in flows](https://machine-path.mintlify.app/built-in-flows.md): Choose among Navi's eight built-in repository search, review, decision, and web research flows.
- [CLI guide](https://machine-path.mintlify.app/cli.md): Use Navi to ask repository questions, run review flows, check work, and inspect sessions.
- [Connect your coding agent](https://machine-path.mintlify.app/connect-your-agent.md): Add Navi's interop skill and project-local launcher without copying either one.
- [Flow schema](https://machine-path.mintlify.app/flow-schema.md): Reference for action.yaml fields, arguments, step types, tools, templates, and compiler limits.
- [Navi](https://machine-path.mintlify.app/index.md): Ask the repository, judge a decision, or challenge a completion claim with evidence your coding agent can revisit.
- [Install or override a flow](https://machine-path.mintlify.app/install-or-override-a-flow.md): Run a flow by path, give it a project-local name, or replace a builtin for one repository.
- [Use Navi with OpenCode](https://machine-path.mintlify.app/opencode.md): Let OpenCode call Navi for a cited repository answer without modifying the repository.
- [Choose a model provider](https://machine-path.mintlify.app/providers.md): Route Navi through a direct model provider or an intentional proxy.
- [Quickstart](https://machine-path.mintlify.app/quickstart.md): Install Navi in an existing repository, choose a model, and get a cited answer.
- [Return a gate](https://machine-path.mintlify.app/return-a-gate.md): Emit a GateDecision from the final step to get gate-aware output, session state, and exit codes.
- [Security and storage](https://machine-path.mintlify.app/security-and-storage.md): What Navi agents can read, which surfaces can write or execute, how secrets are handled, and where sessions are stored.
- [Sessions](https://machine-path.mintlify.app/sessions-and-outcomes.md): Continue one line of work, inspect its record, or branch from it without losing history.
- [Troubleshooting](https://machine-path.mintlify.app/troubleshooting.md): Match a Navi error or symptom to its cause, recovery command, and verification.
- [Write a flow](https://machine-path.mintlify.app/write-a-flow.md): Create an action.yaml, inspect its model-free plan, and run your first command and agent steps.