CLI Reference

Global Flags

These flags work with any command:

Authentication

rf auth login          # Browser-based login
rf auth logout         # Clear local credentials
rf auth whoami         # Show current user and org
rf auth token create   # Create API token
rf auth token list     # List tokens
rf auth token revoke   # Revoke a token
rf auth token rotate   # Rotate a token
rf auth sessions       # List active sessions

Projects

rf projects list           # List all projects
rf projects create <name>  # Create a new project
rf projects delete <name>  # Delete a project
rf projects switch <name>  # Set active project
rf projects info           # Show project details
rf link                    # Link current directory to a project

Deploy

rf deploy                  # Deploy current project
rf deploy --watch          # Stream build logs
rf deploy --env staging    # Deploy to specific environment
rf deploy --branch <name>  # Deploy specific branch
rf deploy --image <url>    # Deploy a Docker image
rf deploy --dry-run        # Build only, don't deploy
rf deploy --no-wait        # Don't wait for healthy
rf deploy --schedule <time> # Deploy at specific time
rf deploy --canary <pct>   # Canary deploy at percentage
rf deploy --rollout <plan> # Gradual rollout
rf up                      # Alias for rf deploy

Services

rf services list                       # List services
rf services create <name> --type web   # Create service
rf services delete <name>              # Delete service
rf services restart <name>             # Restart service
rf services scale <name> --min N --max N  # Scale
rf services info <name>                # Service details
rf add postgres                        # Add managed Postgres
rf add redis                           # Add managed Redis
rf add vector                          # Add vector database
rf add storage                         # Add object storage
rf add queue                           # Add message queue
rf add search                          # Add search
rf add kv                              # Add KV store
rf add email                           # Add email service

Databases

rf db list                         # List databases
rf db connect <name>               # Open interactive shell
rf db query <name> "<sql>"         # Run SQL query
rf db proxy <name>                 # Local proxy (localhost:5432)
rf db backup <name>                # Create backup
rf db restore <name> --to <time>   # Point-in-time restore
rf db import <name> <file>         # Import from dump
rf db export <name>                # Export database
rf db upgrade <name> --plan <plan> # Change plan
rf db branch <name> --name <branch> # Create branch
rf db branches <name>              # List branches
rf db diff <name> --env a --env b  # Compare schemas
rf db merge <branch> --to <name>   # Merge branch schema
rf db insights <name>              # Slow queries & recommendations
rf db replicas add <name> --region <r>  # Add read replica
rf db config <name> <key> <value>  # Set database config

Environment Variables

rf env list                    # List variables (masked)
rf env set KEY=VALUE           # Set variable
rf env get <KEY>               # Get value
rf env delete <KEY>            # Delete variable
rf env pull                    # Remote → local .env
rf env push                    # Local .env → remote
rf secrets set KEY=VALUE       # Set encrypted secret
rf secrets rotate <KEY>        # Rotate credential

Domains

rf domains list                # List domains
rf domains add <domain>        # Add custom domain
rf domains remove <domain>     # Remove domain
rf domains verify <domain>     # Check DNS + SSL
rf domains cert <domain>       # Upload custom certificate

Cron & Jobs

rf cron list                   # List cron jobs
rf cron add "<schedule>" "<cmd>" --name <n>  # Add cron
rf cron remove <name>          # Remove cron
rf cron run <name>             # Manual trigger
rf cron pause <name>           # Pause cron
rf cron resume <name>          # Resume cron
rf cron logs <name>            # View execution history
rf queues list                 # List queues
rf queues info <name>          # Queue stats
rf queues retry <name>         # Retry failed jobs
rf queues purge <name>         # Purge queue

Logs & Monitoring

rf logs                        # Stream live logs
rf logs --service <name>       # Filter by service
rf logs --since 1h             # Time range
rf logs --level error          # Filter by level
rf logs --search "keyword"     # Text search
rf metrics                     # Service metrics overview
rf metrics --service <name>    # Specific service
rf traces --service <name>     # Distributed traces
rf errors --service <name>     # Error groups
rf alerts list                 # List alerts
rf alerts create               # Create alert

Deployments

rf deployments list            # List deployments
rf deployments info <id>       # Deployment details
rf deployments rollback        # Rollback to previous
rf deployments rollback <id>   # Rollback to specific
rf deployments promote         # Promote staging → production
rf deployments cancel          # Cancel in-progress
rf canary status               # Canary deployment status
rf canary promote --percent N  # Increase canary traffic
rf canary abort                # Abort canary

Infrastructure

rf regions list                # Available regions
rf regions add <region>        # Add region to project
rf storage ls <path>           # List storage files
rf storage cp <src> <dst>      # Copy files
rf storage sync <src> <dst>    # Sync directory
rf cdn purge <path>            # Purge CDN cache
rf kv set <key> <value>        # Set KV pair
rf kv get <key>                # Get KV value
rf email domain add <domain>   # Add email domain
rf search query <index> <q>    # Search query

Debugging

rf ssh <service>               # SSH into container
rf exec <service> "<cmd>"      # Run command in container
rf port-forward <svc> <ports>  # Forward ports locally
rf tunnel --port <port>        # Public tunnel to localhost
rf doctor                      # Diagnostic check

Chaos & Cost

rf chaos latency <svc> --ms N  # Inject latency
rf chaos kill <svc>             # Kill instance
rf chaos network <svc>          # Network failure
rf chaos resilience-report      # Resilience score
rf cost                         # Current spending
rf cost forecast                # Predicted bill
rf cost optimize                # Right-sizing tips
rf budget set <amount>          # Set budget alert

Config & Meta

rf config validate             # Validate raidframe.yaml
rf config generate             # Auto-generate config
rf open                        # Open dashboard in browser
rf status                      # Platform status
rf update                      # Update CLI
rf version                     # Show version
rf completion bash/zsh/fish    # Shell completions
rf mcp install                 # Install MCP server
rf vpn connect                 # Connect VPN
rf vpn disconnect              # Disconnect VPN