warphost

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.