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:
--project <slug> to commands that act on a project.
empirical clone
Clone a project’s test repository.
Examples:
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: