qualityexec-cli

QualityExec Platform CLI - AI-optimized command line interface for test execution.

Installation

npm install -g qualityexec-cli

Or use with npx:

npx qualityexec-cli qexec --help

Configuration

Create .qualityexecrc in your project root:

apiUrl: http://localhost:21010
apiKey: your-api-key
format: json  # Use JSON for AI/scripting

Or use environment variables:

export QUALITYEXEC_API_URL=http://localhost:21010
export QUALITYEXEC_API_KEY=your-api-key
export QUALITYEXEC_FORMAT=json

Usage

For AI Agents (JSON output)

# List all systems
qexec -f json systems list

# Run tests
qexec -f json executions trigger --system-id 1

# Check status
qexec -f json executions status 123

For Humans (text output)

# Pretty printed tables
qexec systems list

# Colored output
qexec executions trigger --system-id 1

Commands

| Command | Description | |---|---| | systems | Manage test systems (CRUD, connection test, analyze, resources) | | cases | Manage test cases (CRUD, analyze, versions, lint, debug, out-of-sync) | | plans | Manage test plans (was workflows; suites internally) | | executions | Run and monitor test executions (watch, report, deps) | | run | Synchronous execution entry point (code/file/case/action/suite/plan, optional --on-session) | | drafts | Review AI-generated draft cases (approve/reject/batch) | | actions | Manage reusable action snippets | | recipes | Compose multi-step test recipes | | suites | Manage test suites (internal grouping for plans) | | sessions | Manage browser sessions | | agent | Control the local execution agent (start/run/stop/sync/push) | | local | Local (agent-side) data operations | | params | Manage parameterized test data | | credentials | Manage system credentials/API keys | | hooks | Manage lifecycle hooks (beforeAll/afterAll/...) | | mail | Manage email notification configs | | notifications | Manage in-app notifications | | scheduled-tasks | Manage scheduled test runs | | tasks | Manage async tasks | | jobs | Inspect execution jobs | | files | Manage uploaded test files | | case-folders | Manage case folders | | reviews | Manage draft review decisions | | references | Manage references | | api-keys | Manage API keys | | reports | View execution statistics and trends | | config | View and edit CLI configuration | | doctor | Diagnose CLI environment and connectivity |

Run qexec <command> --help for subcommands and options of each group.

Requirements

• Node.js >= 18

License

MIT

Skill manuals (bundled)

The AI-facing manuals ship inside this package under skills/ and travel with every install — no repo checkout needed:

• qualityexec — case lifecycle playbooks (create / debug / quick-loop)
• qualityexec-cli — full command reference
• qualityexec-case-code — case-code ctx API + component systems

qexec skills list                    # bundled skills + install status
qexec skills install                 # copy into ~/.agents/skills (any workspace can trigger them)
qexec skills install --link          # dev mode: link back to this checkout, edits are live
qexec skills path                    # bundled root (assets like the mock-login fixture resolve from here)

Reinstalling after a manual update always covers: the install stamp carries the CLI version plus a content hash of each skill directory, so skills install refreshes copies whose content drifted even when the version number didn't change. --force re-materializes even when everything already matches.