CLI Reference
Commands grouped by hosted production path, local setup and smoke tests, artifact utilities, and advanced workflows.
Primary public commands
Start here for a repo you want Determina to review.
| Command | Use it for |
|---|---|
| setup | Configure the current repo, create starter review files, run checks, and print one next command. |
| review run | Run the configured starter review. After setup, the recipe path is usually optional. |
| review compare | Compare two hosted snapshots with a review recipe. |
| runs list | List saved review result bundles from a local artifact root. |
| runs show | Inspect one saved review result by id, hash, path, or bundle directory. |
| doctor | Check local Determina setup, capture paths, recipe paths, auth state, and instrumentation hints. |
Review-facing aliases are available for result inspection:
shell
determina review list --root .determina/runs determina review show <run-id-or-path>
Advanced hosted commands
Use these when you need explicit platform objects, platform status polling, or artifact retrieval outside the setup-first review path.
| Command | Use it for |
|---|---|
| api-health | Check API connectivity. |
| projects list/create | Advanced hosted Project management. |
| systems list/create | Advanced hosted System setup. |
| system-versions list/create | Advanced explicit baseline or candidate version management. |
| audit --project-id --system-version-id | Advanced hosted audit by explicit version id. |
| run-swarm --project-id --system-version-id | Queue a platform-backed intent-driven workflow for enabled System Types. |
| compare --project-id --baseline-id --candidate-system-version-id | Advanced direct compare by explicit platform ids. Prefer `review compare` for code-native reviews. |
| runs status/cancel | Inspect or cancel hosted worker-backed runs. |
| artifacts download | Download platform artifacts. |
Advanced local/reference commands
These commands are still available, but they are not part of first-run onboarding.
| Command | Use it for |
|---|---|
| connect | Compatibility command for setup-first repo configuration. |
| init | Generate starter driver configs. |
| check-system | Validate a local external endpoint or driver config. |
| artifacts inspect | Inspect a local artifact file or directory. |
| validate-spec | Validate a source spec envelope without executing. |
| preview-upload | Preview a hosted request shape from a source spec. |
| snapshot create | Package a code-native agent snapshot for hosted review. |
Advanced generated and plan-first workflows
These surfaces are reference workflows for generated test cases, corpus review, and explicit plan handoff.
| Command | Use it for |
|---|---|
| plan-from-spec | Compile a source spec into a run plan. |
| plan-run | Create a run plan through platform/core-owned planning. |
| execute-plan | Execute a saved run plan through platform/core-owned execution. |
| generate-scenarios / generate-personas | Generate recommender or search packs through platform/core workflows. |
| generate-agent-pack | Generate agent task/environment packs through platform/core workflows. |
| import-traces | Import normalized traces into review artifacts. |
| corpus index/import/reconcile/health/list/show/open | Review local artifact corpora and test case sidecars. |
| serve-reference | Reference service workflow gated outside the installed public package. |