WarpHost CLI

Deploy preview environments at warp speed.

Installation

npm install -g warphost

Or use directly with npx:

npx warphost deploy

Quick Start

# Authenticate with GitHub
warphost login

# Deploy your current branch
warphost deploy

# Watch deployment progress
warphost deploy --watch

# Check environment status
warphost status <environment-id>

# View deployment logs
warphost logs <environment-id>

# Destroy an environment
warphost destroy <environment-id>

Commands

| Command | Description | |---------|-------------| | login | Authenticate with WarpHost via GitHub | | logout | Clear stored credentials | | whoami | Show current user info and usage | | deploy | Deploy the current branch | | status | Check environment status | | logs | View deployment logs | | destroy | Destroy an environment |

Deploy Options

warphost deploy [options]

Options:
  -b, --branch <branch>    Branch to deploy (default: current branch)
  -w, --watch              Watch deployment progress
  -e, --env <KEY=VALUE>    Environment variables (can use multiple)
  --ttl <hours>            Time to live in hours
  --subdomain <name>       Custom subdomain (Pro+ only)

JSON Output

All commands support --json flag for scripting:

warphost status abc123 --json

Configuration

CLI configuration is stored in ~/.warphost/config.json:

• token - Authentication token
• api_url - API base URL (default: https://api.warphost.io)
• frontend_url - Frontend URL (default: https://warphost.io)

Troubleshooting

"Not authenticated" error

Run warphost login to authenticate.

Token expired

Your session may have expired. Run warphost login to re-authenticate.

Browser doesn't open during login

Use the --no-browser flag and manually visit the URL:

warphost login --no-browser

Development

# Install dependencies
npm install

# Build
npm run build

# Link for local testing
npm link

# Run in development
npm run dev

Links

• Documentation
• Dashboard
• Support

License

Proprietary. Copyright (c) 2025 WarpHost. All rights reserved.