DeterminadocsbyNDETERMINA
Start

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

shell
export DETERMINA_API_BASE_URL=https://api.ndetermina.com
export DETERMINA_API_TOKEN=<token>
VerifyAuthenticated review commands fail before making requests when no token is configured.

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.

shell
determina setup
VerifySetup should create or reuse .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.

shell
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.

shell
determina runs list --root .determina/runs
determina runs show <run-id-or-path>

You can also use the review-facing aliases:

shell
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.

Advanced setup