Skip to main content
This page lists every command of the empirical CLI. Add --help to any command to print the same help in your terminal. To install the CLI and sign in, see CLI.

Get started

empirical login

Authorize the CLI with Empirical.

empirical signup

Create an Empirical account and log in.

empirical logout

Clear stored CLI authorization.

empirical whoami

Print the signed-in identity and its projects.

empirical skill

Manage skills for local coding agents.

empirical skill install

Install the Empirical SKILL.md for local coding agents.

empirical feedback

Tell the Empirical team what is broken, missing or confusing.
Examples:

Project and repository

empirical projects

List the projects you can access.
Examples:
Pass a slug as --project <slug> to commands that act on a project.

empirical clone

Clone a project’s test repository.
Examples:
Run empirical projects to list the projects you can see.

empirical git

Work with the git.empirical.run remote.

empirical git setup

Configure git to authenticate to git.empirical.run with your Empirical login.

empirical environments

Inspect environments in ENVIRONMENTS.yaml and write their .env files.

empirical environments show

List the environments, or with —environment show every variable of one environment, its value and where it comes from.

empirical environments pull

Write each environment’s .env file with the dashboard’s current variables. Prints variable names, never values.

Actions

empirical session

Send prompts to agent sessions.
Examples:

empirical session list

List sessions.

empirical session status

Show current state, latest activity, branches, and pull requests.

empirical session logs

Print session history (user and assistant messages, tool calls); -f to follow live.
Examples:

empirical test-runs

Trigger test runs and wait for results.

empirical test-runs trigger

Start a full test run.
Examples:

empirical test-runs status

Print a run’s state and result counts.

empirical test-runs wait

Wait for a run to end; exit code 0 means it passed.

empirical api

Call an Empirical API endpoint.
Examples:

empirical kv

Read and write the project key-value store.

empirical kv get

Print a value (or the whole entry with —entry).

empirical kv set

Write a value; JSON is stored as JSON, anything else as a string.

empirical kv refresh

Reset a key’s TTL without changing its value.

empirical kv delete

Delete a key.

empirical kv list

List entries in key order, following every page.

empirical upload

Upload a file and print its link.

CLI

empirical version

Print the installed CLI version.

empirical upgrade

Upgrade to the latest published CLI.