CLI

The glubean CLI is the command surface for the local runner. Use it for local development, CI pipelines, uploads, and team workflows.

In a project, keep the authoring API and runner explicit:

• @glubean/sdk — what tests, contracts, workflows, and load plans import.
• @glubean/runner — what executes them and emits structured evidence.
• glubean — the CLI wrapper you call from your terminal or CI.

Start

# Initialize a project. The template adds the SDK/runner dependencies it needs.
npx glubean init
 
# Run CLI commands without installing the CLI globally.
npx glubean <command>

Quick start

# Scaffold a runnable project. The template adds SDK/runner/local CLI deps.
npx glubean init --no-interactive
 
# Run the generated local profile through package scripts
npm test
 
# Or call the project CLI directly
npx glubean run --profile local
 
# Run a single file
npx glubean run tests/users.test.ts

Get help

npx glubean -h              # All commands
npx glubean run -h          # Options for a specific command

Pages in this section

• Usage Scenarios — common commands organized by workflow
• Sync Projections — publish source-derived Specifications to Cloud
• Configuration — glubean.yaml suites, profiles, reporters, upload, and gates
• Environments & Secrets — env files, secrets, switching environments
• Debugging — narrowing failures and inspecting output
• Common Recipes — copy-paste patterns for CI, tags, and more
• Redaction & Privacy — how sensitive data is masked before upload
• Result Files — .result.json format and artifacts