CLI Reference

CLI Reference

Heroku-style command interface for Pvdify.

Status: ⏳ Planned - Not Yet Implemented

The pvdify CLI is currently in development. The commands below represent the planned interface. For now, use the REST API directly or the Admin UI at pvdify.win.

Installation

# Install via script
curl -fsSL https://pvdify.win/install.sh | bash

# Or download binary
curl -L https://pvdify.win/releases/latest/pvdify-linux-amd64 -o /usr/local/bin/pvdify
chmod +x /usr/local/bin/pvdify

# Verify installation
pvdify version

Authentication

# Interactive login (opens browser)
pvdify login

# Login with token
pvdify login --token $PVDIFY_TOKEN

# Check auth status
pvdify auth:whoami

# Logout
pvdify logout

Apps

apps

List all apps.

pvdify apps

Output:

NAME              ENVIRONMENT  STATUS   RELEASE
myapp             production   running  v42
myapp-staging     staging      running  v15
myapp-pr-123      preview      running  v1

apps:create

Create a new app.

pvdify apps:create myapp
pvdify apps:create myapp-staging --environment staging

Options:

Flag	Description
--environment	Environment type (production, staging, preview)

apps:info

Show app details.

pvdify apps:info myapp

Output:

=== myapp
Environment:  production
Status:       running
Image:        ghcr.io/org/app:v1.2.3
Bind Port:    3001
Created:      2026-01-01T10:00:00Z

Processes:
  web.1:    running
  web.2:    running
  worker.1: running

Domains:
  myapp.com
  www.myapp.com

apps:destroy

Delete an app.

pvdify apps:destroy myapp
pvdify apps:destroy myapp --confirm myapp

Options:

Flag	Description
--confirm	Skip confirmation prompt

---

Deploy

deploy

Deploy an image to an app.

pvdify deploy myapp --image ghcr.io/org/app:v1.2.3
pvdify deploy myapp  # Uses image from pvdify.yaml

Options:

Flag	Description
--image	Container image to deploy
--wait	Wait for deploy to complete (default: true)
--timeout	Deploy timeout (default: 5m)

releases

List releases for an app.

pvdify releases myapp

Output:

VERSION  IMAGE                          STATUS      CREATED
v42      ghcr.io/org/app:v1.2.3        active      2026-01-05T10:30:00Z
v41      ghcr.io/org/app:v1.2.2        superseded  2026-01-04T10:00:00Z
v40      ghcr.io/org/app:v1.2.1        superseded  2026-01-03T10:00:00Z

rollback

Rollback to a previous release.

pvdify rollback myapp              # Previous release
pvdify rollback myapp --version 40 # Specific version

Options:

Flag	Description
--version	Target release version

---

Config

config

Show config vars for an app.

pvdify config myapp

Output:

=== myapp Config Vars
NODE_ENV:     production
DATABASE_URL: postgres://...
API_KEY:      [REDACTED]

config:set

Set config vars.

pvdify config:set myapp KEY=value
pvdify config:set myapp KEY1=val1 KEY2=val2
pvdify config:set myapp --secret API_KEY=sk_live_...

Options:

Flag	Description
--secret	Encrypt value with SOPS

config:unset

Remove config vars.

pvdify config:unset myapp KEY
pvdify config:unset myapp KEY1 KEY2

config:versions

Show config version history.

pvdify config:versions myapp

Output:

VERSION  CREATED               CHANGES
v3       2026-01-05T10:30:00Z  API_KEY
v2       2026-01-03T10:00:00Z  DATABASE_URL
v1       2026-01-01T10:00:00Z  NODE_ENV

---

Domains

domains

List domains for an app.

pvdify domains myapp

Output:

DOMAIN           STATUS  SSL
myapp.com        active  true
www.myapp.com    active  true

domains:add

Add a domain to an app.

pvdify domains:add myapp myapp.com
pvdify domains:add myapp api.myapp.com

domains:remove

Remove a domain from an app.

pvdify domains:remove myapp old.myapp.com

---

Processes

ps

List running processes.

pvdify ps myapp

Output:

TYPE    COUNT  STATUS   COMMAND
web     2      running  npm start
worker  1      running  npm run worker

ps:scale

Scale process count.

pvdify ps:scale myapp web=3
pvdify ps:scale myapp web=2 worker=2

ps:restart

Restart processes.

pvdify ps:restart myapp          # All processes
pvdify ps:restart myapp --type web  # Specific type

Options:

Flag	Description
--type	Process type to restart

---

Logs

logs

View application logs.

pvdify logs myapp
pvdify logs myapp -f              # Follow/stream
pvdify logs myapp -n 200          # Last 200 lines
pvdify logs myapp --process web   # Filter by process

Options:

Flag	Description
-f, --follow	Stream new logs
-n, --lines	Number of lines (default: 100)
--process	Filter by process type
--since	Start time (e.g., “1h”, “2026-01-05”)

---

Run

run

Run a one-off command.

pvdify run myapp -- npm run migrate
pvdify run myapp -- bash
pvdify run myapp --detach -- npm run long-task

Options:

Flag	Description
--detach	Run in background
--timeout	Command timeout

---

Maintenance

maintenance:on

Enable maintenance mode.

pvdify maintenance:on myapp

maintenance:off

Disable maintenance mode.

pvdify maintenance:off myapp

---

Version

version

Show CLI version.

pvdify version

Output:

pvdify/1.0.0 linux-amd64 go1.21

---

Global Options

Flag	Description
--app, -a	App name (can be set in pvdify.yaml)
--format	Output format (table, json, yaml)
--quiet	Suppress output
--verbose	Verbose output

---

Configuration File

Create pvdify.yaml in your project root:

app: myapp
image: ghcr.io/org/app

processes:
  web:
    command: npm start
    count: 2
  worker:
    command: npm run worker
    count: 1

resources:
  memory: 512M
  cpu: 0.5

healthcheck:
  path: /health
  interval: 30s

hooks:
  pre_deploy:
    - npm run migrate
  post_deploy:
    - npm run cache:clear

Commands automatically use values from pvdify.yaml:

# In project directory with pvdify.yaml
pvdify deploy        # Uses app and image from config
pvdify logs -f       # Uses app from config

---

Environment Variables

Variable	Description
PVDIFY_TOKEN	Authentication token
PVDIFY_APP	Default app name
PVDIFY_API_URL	API endpoint (default: https://pvdify.win)

---

Exit Codes

Code	Description
0	Success
1	General error
2	Invalid arguments
3	Authentication error
4	Not found
5	Deploy failed