📚 MicroRapid CLI Commands Reference

📋 Complete Command Reference

Core Commands

Collection Commands

Authentication Commands

Environment Commands

🎯 Command Options Reference

init Command Options

mrapids init <project-name> [options]

list Command Options

mrapids list [options]

run Command Options

mrapids run <operation> [options]

validate Command Options

mrapids validate <spec-file> [options]

doctor Command Options

mrapids doctor [options]

Check areas:

• config - Configuration files
• auth - Authentication setup
• spec - OpenAPI specification
• env - Environment variables

diff Command Options

mrapids diff <old-spec> <new-spec> [options]

gen Command Options

mrapids gen <type> [options]

Generation Types:

Common Options:

collection Command Options

mrapids collection <subcommand> [options]

collection run Options:

collection test Options:

📖 Complete Examples

Basic API Execution

# Simple GET request
mrapids run GetUser --param id=123

# With environment and authentication
mrapids run GetUser \
  --param id=123 \
  --env production \
  --profile api-key-prod

# POST with file and save to collection
mrapids run CreateUser \
  --file user-data.json \
  --env staging \
  --profile oauth-staging \
  --save-to-collection

Working with GitHub API

# Initialize GitHub API project
mrapids init github-api \
  --from-url https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json

# List repository operations
mrapids list --filter repo --method POST

# Get repository details
mrapids run repos/get \
  --param owner=microsoft \
  --param repo=vscode \
  --env production \
  --profile github-main

# Create repository with interactive mode
mrapids run repos/create-for-user -i
# Edit the generated template, then:
mrapids run repos/create-for-user \
  --file create_repo_request.json \
  --env production \
  --profile github-main \
  --save-to-collection

Authentication Setup

# Detect required authentication
mrapids auth detect --spec api.yaml

# Configure API key authentication
mrapids auth connect api-key

# Login to GitHub OAuth
mrapids auth login github

# Test authentication profile
mrapids auth test --profile github-main

# Validate production credentials
mrapids auth validate --profile production

Environment Management

# List all environments
mrapids env list

# Create QA environment
mrapids env create qa --base-url https://qa-api.example.com

# Switch default environment
mrapids env use staging

# Show environment details
mrapids env show production

Collection Management

# Create new collection
mrapids collection create smoke-tests

# Validate collection syntax
mrapids collection validate smoke-tests

# Run collection with variables
mrapids collection run user-onboarding \
  --env staging \
  --profile test-creds \
  --var email="test@example.com" \
  --var username="testuser"

# Run as tests with report
mrapids collection test regression-suite \
  --env staging \
  --profile qa-automation \
  --report junit > test-results.xml

API Validation and Testing

# Validate OpenAPI spec
mrapids validate api-spec.yaml --strict --lint

# Check for breaking changes
mrapids diff v1.0/api.yaml v2.0/api.yaml --breaking-only

# Run all tests
mrapids test --all --env staging --profile qa

# Diagnose issues
mrapids doctor --env production --fix

Code Generation

# Generate TypeScript SDK
mrapids gen sdk \
  --language typescript \
  --output ./sdk/typescript \
  --package-name "@company/api-client" \
  --with-docs \
  --with-tests

# Generate test fixtures
mrapids gen fixtures \
  --count 100 \
  --seed 42 \
  --output ./test-data

# Generate curl examples
mrapids gen snippets \
  --format curl \
  --output ./docs/examples

Advanced Query Building

# Interactive query builder
mrapids run searchProducts --build-query

# Complex query with filters
mrapids run searchProducts \
  --param q="category:electronics price:>100" \
  --param sort="price:asc" \
  --param page=1 \
  --param limit=20 \
  --env production \
  --profile api-key

# Use query file
cat > query.json << EOF
{
  "filter": "status = 'active' and created >= '2024-01-01'",
  "sort": "created:desc",
  "page": 1,
  "limit": 50
}
EOF

mrapids run listItems --query-file query.json

Debugging and Development

# Preview request without sending
mrapids run DeleteUser \
  --param id=123 \
  --dry-run

# Show as curl command
mrapids run DeleteUser \
  --param id=123 \
  --as-curl

# Trace HTTP traffic
mrapids run GetUser \
  --param id=123 \
  --trace \
  --verbose

# Replay last successful request
mrapids run GetUser --replay-last

🎓 Pro Tips

1. Use Environment-Specific Configs

# Development with verbose output
mrapids run GetUser --env dev --verbose

# Production with specific profile
mrapids run GetUser --env prod --profile prod-readonly

2. Chain Operations with Collections

# .mrapids/collections/user_flow.yaml
requests:
  - name: Create User
    operation: CreateUser
    save_as: user
  
  - name: Add Payment Method
    operation: AddPaymentMethod
    params:
      user_id: "{{ user.id }}"
    depends_on: ["Create User"]

3. Interactive Mode for Complex Requests

# Generate minimal template
mrapids run ComplexOperation -i --minimal

# Generate full template with all fields
mrapids run ComplexOperation -i --full

4. Always Validate Before Production

# Dry run first
mrapids run DeleteUser --param id=123 --dry-run

# Check as curl
mrapids run DeleteUser --param id=123 --as-curl

# Validate spec changes
mrapids diff old.yaml new.yaml --breaking-only

5. Set Up Proper Authentication Profiles

# Create profile for each environment
cat > .mrapids/auth/prod.toml << EOF
[profile]
name = "production"
type = "bearer"

[auth]
token_env = "PROD_API_TOKEN"
EOF

# Use environment-specific profiles
mrapids run GetUser --env production --profile prod

🔗 Supported Formats

mrapids init your-api --from-url https://your-api.com/openapi.json