CLI
The PETROVA CLI is the primary surface for invoking verbs. Everything in this section walks you through installing it, configuring credentials, and using it day-to-day.
Quick reference
Section titled “Quick reference”| Page | What it covers |
|---|---|
| Install | Clone, build, link the binary. ~5 minutes. |
| Auth | PAT vs GitHub App. Required scopes per verb category. |
| Command reference | Every command, flag, and exit code. |
| Configuration | Environment variables. |
| Output formats | Table / --json / --format markdown. |
What the CLI does
Section titled “What the CLI does”Three responsibilities:
- Read governed repos via local clones (
status,diagnose,validate,dashboard). - Validate verb inputs against schemas before any side effect.
- Emit PRs through the GitHub Contents API for write verbs.
The CLI does not store state, does not run a daemon, does not
persist anything between invocations except the
~/.petrova/diagnoses.jsonl cache used by propose_fix.
See also
Section titled “See also”- Quickstart — first-time end-to-end use.
- Verb reference — the contracts the CLI implements.
- Skills — Claude Code skill wrappers around the CLI.