Testplane CLI is a command line interface for inspecting and controlling a browser from your terminal. It makes possible to perform any browser interactions, inspect HTML Reports and Time Travel snapshots, use REPL mode to debug failing tests and more.

Read the full Testplane CLI documentation.

Installation

Install globally:

npm install -g @testplane/cli

Or run it without installing:

npx @testplane/cli@latest --help

Examples

Open a page and capture a DOM snapshot:

testplane-cli navigate https://example.com
testplane-cli snapshot

Interact with the current page:

testplane-cli click --role button --name "Submit"
testplane-cli type "#email" --value [email protected]

Run custom Testplane code against the active browser session:

testplane-cli run-code "await browser.getUrl()"
testplane-cli run-code --file ./scripts/check-page.js

Capabilities

Testplane CLI runs a reusable local daemon for each project, so commands can share the same browser session across terminal invocations.

• Various browser interactions: navigate pages, click and type into elements, manage tabs, read console output, take screenshots, and inspect DOM or visual state.
• HTML reporter integration: open reports and inspect captured time travel snapshots.
• REPL mode integration for interactive browser exploration from the terminal.
• Save and restore browser state to handle authenticated flows.
• Run arbitrary Testplane code when built-in commands are not enough.