Motus.Cli 1.0.13

Motus.Cli

Command-line tool for the Motus browser automation framework. Run tests, record interactions, manage browser installations, and inspect traces from your terminal.

Installation

# Global install
dotnet tool install -g Motus.Cli

# Local install (per-project)
dotnet tool install Motus.Cli

# Update
dotnet tool update -g Motus.Cli

Requires .NET 8.0 SDK or later.

Commands

motus run

Discovers and runs tests from compiled assemblies.

# Run all tests
motus run MyTests.dll

# Filter and parallelize
motus run MyTests.dll --filter "Category=Smoke" --workers 4

# Output JUnit XML for CI
motus run MyTests.dll --reporter junit --output results.xml

# Collect JS/CSS coverage; repeat the flag for multiple formats
motus run MyTests.dll --coverage console --coverage html:./coverage

# Retry tests up to twice when the failure is a transient CDP disconnect
motus run MyTests.dll --retries 2

motus record

Launches a headed browser, records interactions, and emits C# test code.

# Record a session
motus record --url https://example.com --output LoginTest.cs

# Connect to an existing browser
motus record --connect ws://localhost:9222 --framework xunit

motus install

Downloads and installs a browser binary.

# Install Chromium
motus install chromium

# Install a specific revision
motus install chrome --revision 1234567

# Install to a custom path
motus install firefox --path ./browsers

motus trace show

Opens a recorded trace in the visual runner. The trace viewer displays a timeline of browser events with timestamps, durations, screenshots, and network requests extracted from the trace ZIP.

motus trace show trace.zip --port 5200

motus screenshot

Captures a screenshot from a URL.

# Basic capture
motus screenshot https://example.com --output page.png

# Full page capture at a specific viewport size
motus screenshot https://example.com --output page.png --full-page --width 1920 --height 1080

# Wait for JS-heavy sites and remove cookie banners
motus screenshot https://example.com --output page.png --delay 5 --hide-banners

motus pdf

Generates a PDF from a URL.

# Basic PDF
motus pdf https://example.com --output page.pdf

# Wait for client-side rendering and remove banners
motus pdf https://example.com --output page.pdf --delay 5 --hide-banners --width 1440

motus codegen

Generates Page Object Model classes from live web pages by crawling the DOM and inferring selectors.

# Generate from a URL (headless)
motus codegen https://example.com/login --output ./Pages --namespace MyApp.Pages

# Open a browser, navigate yourself, then press Enter to analyze
motus codegen --headed --output ./Pages

# Navigate to a URL in a visible browser, interact, then press Enter
motus codegen https://example.com/login --headed --output ./Pages

# Connect to an already-running browser's active tab
motus codegen --connect ws://localhost:9222 --output ./Pages

# Only analyze elements inside a modal or specific container
motus codegen --headed --scope ".modal-dialog" --output ./Pages
motus codegen https://example.com/login --scope "#login-form" --output ./Pages

motus update-protocol

Updates the bundled CDP protocol JSON files to the latest version.

motus mcp

Runs the Model Context Protocol server so AI agents can drive a browser through Motus. Tools cover navigation, accessibility snapshots, interaction, network interception, accessibility and performance audits, and Page Object Model generation. Serves over stdio by default, or Streamable HTTP for concurrent remote clients.

# Register with Claude Code against the installed tool
claude mcp add motus -- motus mcp

# Drive a specific browser, or show a visible window for debugging
motus mcp --channel chrome
motus mcp --headless false

# Serve over Streamable HTTP (a non-loopback bind requires a token)
motus mcp --http --host 0.0.0.0 --port 8931 --token "$MOTUS_MCP_TOKEN"

Run motus install first so a browser is available. See the MCP Server guide for the full registration story and tool catalog.