CLI Commands

Complete command reference

Run Command

Execute tests from a collection file:

Terminal
zelte run [collection] [options]

Options:
  -e, --env <name>        Environment to use
  -o, --output <format>   Output format (table, json, tap)
  --timeout <ms>          Request timeout in milliseconds
  --filter <pattern>      Regex pattern to filter tests
  --verbose               Verbose output with details
  --parallel              Enable parallel execution

Examples

Common usage patterns:

Terminal
# Run all tests
zelte run collection.yaml

# Run with specific environment
zelte run collection.yaml --env production

# Output as JSON for CI
zelte run collection.yaml --output json

# Run with verbose output
zelte run collection.yaml --verbose

# Filter tests by name
zelte run collection.yaml --filter "auth"

Init Command

Initialize a new Zelte project:

Terminal
zelte init [directory]

Creates:
  - collection.yaml (test template)
  - .zelte.env.example (env template)
  - README.md (quick reference)

Validate Command

Validate collection files without running:

Terminal
zelte validate collection.yaml
zelte validate collection.yaml --env production