CLI

The Puchify CLI gives you terminal-native access to manage all cloud resources. Built with termcn (Ink + React for the terminal), it delivers polished interactive UIs in TTY mode and clean scriptable output in CI.

Installation

# npm
npm install -g puchify

# Homebrew
brew install puchify/tap/puchify

# Direct execution (no install)
npx puchify servers list

Quick usage

# Authenticate
export PUCHIFY_API_KEY=pk_xxxx

# List servers
puchify servers list

# Create a server
puchify servers create --name web-01 --plan shared-2 --region us-east

# Open a terminal session
puchify terminal svr_abc123

# Chat with the AI agent
puchify agent chat

Interactive vs. script mode

The CLI automatically detects whether it's running in a terminal:

Interactive (default TTY) — beautiful termcn UI with tables, spinners, progress bars, and confirmation dialogs.

Script (pipe/CI) — plain text output, no confirmations, clear exit codes.

# Script mode is automatic in CI
puchify servers list --quiet -o json

# Pipe-friendly output
puchify servers list -o ids | xargs -I{} puchify servers restart {}

Output formats

Every command supports --output / -o:

puchify servers list                    # table (default)
puchify servers list -o json           # JSON
puchify servers list -o json-pretty    # pretty JSON
puchify servers list -o yaml           # YAML
puchify servers list -o ids            # IDs only, one per line

Tab completion

# Bash
puchify completion bash >> ~/.bashrc

# Zsh
puchify completion zsh >> ~/.zshrc

# Fish
puchify completion fish >> ~/.config/fish/completions/puchify.fish

Themes

The CLI ships with a Puchify-branded theme. Override to any of 35+ built-in termcn themes:

puchify config set theme dracula
puchify config set theme default