@provartesting/provardx-cli

What is the ProvarDX CLI?

The Provar DX CLI is a Salesforce CLI plugin for Provar customers who want to automate the execution of tests using Provar Automation, and the reporting of test results and other quality-related metrics to Provar Quality Hub.

Installation, Update, and Uninstall

Requires Node.js 18–24 (LTS 22 recommended). Node 25+ is not yet supported due to a breaking change in a transitive dependency. Check with node --version.

Install the plugin

$ sf plugins install @provartesting/provardx-cli@beta

Update plugins

$ sf plugins update

Uninstall the plugin

$ sf plugins uninstall @provartesting/provardx-cli

MCP Server (AI-Assisted Quality)

The Provar DX CLI includes a built-in Model Context Protocol (MCP) server that connects AI assistants (Claude Desktop, Claude Code, Cursor) directly to your Provar project. Once connected, an AI agent can inspect your project structure, generate Page Objects and test cases, validate every level of the test hierarchy with quality scores, and work with NitroX (Hybrid Model) component page objects for LWC, Screen Flow, Industry Components, Experience Cloud, and HTML5.

Validation runs in two modes: local only (structural rules, no key required) or Quality Hub API (170+ rules, quality scoring — requires a pv_k_ API key). Don't have an account? Request access.

Quick setup

Requires: Provar Automation IDE installed with an activated license.

# 1. Install the plugin — @beta is required for MCP support
sf plugins install @provartesting/provardx-cli@beta

# 2. (Optional) Authenticate for full 170+ rule validation
sf provar auth login

Claude Code — run once to register the server:

claude mcp add provar -s user -- sf provar mcp start --allowed-paths /path/to/your/provar/project

Claude Desktop — add to your config file and restart the app:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "provar": {
      "command": "sf",
      "args": ["provar", "mcp", "start", "--allowed-paths", "/path/to/your/provar/project"]
    }
  }
}

Windows (Claude Desktop): Use sf.cmd instead of sf if the server fails to start.

📖 docs/mcp.md — full setup, all 35+ tools, 7 MCP prompts, troubleshooting.

Commands

• sf provar auth login
• sf provar auth rotate
• sf provar auth status
• sf provar auth clear
• sf provar mcp start
• sf provar config get
• sf provar config set
• sf provar automation config generate
• sf provar automation config load
• sf provar automation config validate
• sf provar automation config get
• sf provar automation config set
• sf provar automation setup
• [`sf

... View full README on GitHub