CLI

PullPreview CLI

Use the released pullpreview binary to run preview commands locally, including full up/down/list flows for debugging and manual deployments.

Install

Download the CLI from GitHub Releases and add it to your PATH:

REPO="pullpreview/action"
TAG="v1.0.0" # replace with the release tag you want
PLATFORM="linux-amd64"

curl -L -o pullpreview.tar.gz \
  "https://github.com/${REPO}/releases/download/${TAG}/pullpreview_${TAG}_$(echo "${PLATFORM}" | tr '-' '_').tar.gz"

tar -xzf pullpreview.tar.gz
chmod +x pullpreview
sudo mv pullpreview /usr/local/bin/pullpreview

On Windows, download the .zip archive and extract pullpreview.exe.

You can also build from source:

go run ./cmd/pullpreview --help
go build -o pullpreview ./cmd/pullpreview

Basic commands

# Deploy a local project
pullpreview up ./path/to/app --name pullpreview-local --instance-type small --region us-east-1

# List deployments created by PullPreview
pullpreview list
pullpreview list org/repo

# Destroy a deployment by instance name
pullpreview down --name pullpreview-local

Other command:

pullpreview github-sync ./path/to/app

Hetzner local usage

For provider: hetzner, use CLI flags and PULLPREVIEW_PROVIDER:

• PULLPREVIEW_PROVIDER=hetzner (env)
• HCLOUD_TOKEN (env)

Example:

PULLPREVIEW_PROVIDER=hetzner \
HCLOUD_TOKEN=... \
pullpreview up ./path/to/app \
  --region nbg1 \
  --image ubuntu-24.04 \
  --instance-type cpx21

If you keep values in a .env file, source it manually before commands:

set -a
. ./.env
set +a

Notes

• --region and --image are the only region/image inputs used by the CLI and action.
• --instance-type controls the instance size for both AWS and Hetzner.