Install

Install the Rima CLI globally from npm:

npm install --global @rimatest/local-runner

Once installed, confirm the rima command is available:

rima --help

Connect

Run the login command, then sign in and approve the CLI in your browser:

rima login
The code expires in 10 minutes. The CLI exchanges it for a revocable device token.

Run Locally

  1. Start the app you are developing.
  2. Select the Rima project.
  3. Run all tests, or one particular test.
npm run dev rima use Example rima run --port 3000

Run one saved play/test by ID, name, or slug:

rima run login-flow --port 3000

URL Rewriting

If the recorded test starts with https://example.com, the runner uses the project primary domain or the recording itself to identify that origin and rewrites it to the target URL.

  • page.goto("https://example.com/login") becomes http://localhost:3000/login.
  • URL validations such as url_equals and url_contains are rewritten too.
  • Requests and redirects back to the deployed origin are continued against the local base URL when the runner can intercept them.

Use --target-url for staging or another private address. Pass --recorded-origin only when the project primary domain and automatic inference do not identify the correct original domain.

Logs and Files

CLI logs and local copies of run files are written on the developer machine:

~/.rima/logs/rima-cli-YYYY-MM-DD.log ~/.rima/runs/<run-id>/summary.json

The run summary, failure screenshots, trace zip, and optional videos are uploaded to Rima and appear in Recent Runs with local-cli as the source.