Approxima CLI

Run AI agents that test your app in a real browser — from the terminal.

Approxima plugs into your CI/CD and runs AI agents on every pull request. They build your app, test it in a real browser, and report exactly what's broken — with screenshots. This CLI lets you trigger and monitor those runs without leaving your terminal.

Install

npm install -g @approxima/cli

Or run directly:

npx @approxima/cli

Quick start

# Authenticate
approxima login

# List your journeys
approxima ls --journeys

# Run a journey and watch it live
approxima run --journey "Checkout flow"

# Trigger a PR review
approxima run --pr 42

# Explore your app with a goal — the agent figures out the steps
approxima explore "Add an item to the cart and check out"

Commands

login / logout

Authenticate with your Approxima account.

org

View or switch your active organization.

approxima org              # show current org
approxima org ls           # list all orgs
approxima org switch Acme  # switch by name or id

ls

Browse journeys, suites, and run history.

approxima ls --journeys                     # list available journeys
approxima ls --suites                       # list available suites
approxima ls --journey "Checkout flow"      # history for one journey
approxima ls --pr 42                        # history for a PR
approxima ls --active                       # currently running
approxima ls --status failed --limit 50     # filter by status

run

Start a journey, suite, or PR review. Blocks and streams progress by default.

approxima run --journey "Checkout flow"     # run a single journey
approxima run --suite "Smoke suite"         # run all journeys in a suite
approxima run --pr 42                       # trigger a PR review
approxima run --journey "Checkout flow" --no-wait   # fire and forget

explore

Give the agent a goal in plain English. It navigates your app, discovers the steps, and offers to save them as a reusable journey.

approxima explore "Sign up for a new account"

Options

| Flag | Description | |------|-------------| | --app <name-or-id> | Target a specific app (auto-detected from git remote by default) | | --no-wait | Start the run and exit immediately | | --limit <n> | Number of results to show (default: 20) |

Requirements

• Node.js 20+
• A GitHub repo connected to Approxima

Links

• Website
• GitHub App