Hosted Quickstart
Configure the API, create a Project, register a System Version, run a Behavior Trial, and download artifacts.
Before you start
You need a Determina platform API base URL and API token. The quickstart assumes you are inside the repository for the app or agent you want to review.
Configure the CLI
export DETERMINA_API_BASE_URL=https://api.ndetermina.com export DETERMINA_API_TOKEN=<token>
Set up this repo
Run setup once from your app or agent repository. Determina detects the repo shape, writes local defaults, creates a starter review recipe, checks the setup, and prints one next command.
determina setup
.determina/config.yaml and a starter recipe under determina/reviews/.Run your first review
Run the starter review recipe. After setup, you can usually omit the recipe path
and run determina review run; the explicit path below shows what will run.
determina review run determina/reviews/starter.yaml
Determina attaches review metadata automatically when it is available, including git commit, branch, timestamp, package version, and deployment target. The platform uses that metadata to group reviews by commit, branch, and release.
Inspect results
The review command queues hosted work, polls for a terminal state by default, and prints the run id, decision, and platform URL when the API returns them.
determina runs list --root .determina/runs determina runs show <run-id-or-path>
You can also use the review-facing aliases:
determina review list --root .determina/runs determina review show <run-id-or-path>
Use the CLI reference when you need advanced status polling, artifact download, explicit platform objects, generated test cases, or direct audit/compare commands.
Need explicit platform setup?
Advanced compare, CI, and deployed-system workflows can still use Systems and Versions when you need direct control.