HELLCAT

CLI Reference

Complete command-line interface documentation

Installation

npm install -g @hellcat/cli

Authentication

# Login
hellcat login

# Logout
hellcat logout

# Check auth status
hellcat whoami

Credentials stored in ~/.hellcat/config.json

Workflow Commands

# Create workflow from file
hellcat workflows create --file workflow.hell

# List workflows
hellcat workflows list

# Get workflow details
hellcat workflows get <workflow-id>

# Delete workflow
hellcat workflows delete <workflow-id>

Job Commands

# Run a task (discovery mode)
hellcat run "test login on website.com" --follow

# Run with parameters
hellcat run "create account" \
  --param email=user@example.com \
  --param password=secret123 \
  --follow

# Get job status
hellcat jobs get <job-id>

# List jobs
hellcat jobs list --status completed

# Cancel running job
hellcat jobs cancel <job-id>

Module Commands

# Publish module
hellcat modules publish ./my-module.hell \
  --namespace myorg \
  --name my-module \
  --version 1.0.0

# Install module
hellcat modules install @myorg/my-module@1.0.0

# List modules
hellcat modules list

Billing Commands

# Check credit balance
hellcat billing balance

# View transactions
hellcat billing transactions --limit 10

# Apply promo code
hellcat billing promo WELCOME50

Global Options

--api-url - Override API endpoint
--verbose - Enable verbose logging
--json - Output as JSON
--help - Show help

Admin CLI (Luther)

For administrative tasks, use the Luther CLI:

# Login as admin
luther login --secret YOUR_ADMIN_SECRET

# View platform metrics
luther metrics platform

# Manage promo codes
luther promo create LAUNCH100 --credit-bonus 100.00

# Add credits to user
luther credits add <user-id> 50.00

Admin credentials stored in ~/.luther/config.json

← Jobs APIAI Discovery →