CLI

Manage Podstack resources from your terminal using the official command-line interface.

Overview

The Podstack CLI provides a powerful command-line interface for managing GPU cloud resources. Use it for quick operations, scripting, automation, and CI/CD integration.

Quick Example

# Create a GPU pod
podstack pod create \
  --name training-job \
  --image pytorch/pytorch:latest \
  --gpu-type A100 \
  --wait

# SSH into the pod
podstack pod ssh training-job

# Run a command
podstack pod exec training-job -- nvidia-smi

# Delete when done
podstack pod delete training-job

Features

• Cross-Platform - Works on macOS, Linux, and Windows
• Full Coverage - Manage pods, storage, projects
• Multiple Outputs - Table, JSON, YAML formats
• Shell Completion - Tab completion for Bash, Zsh, Fish
• CI/CD Ready - Token-based auth for automation
• Fast & Lightweight - Single binary, no dependencies

Interactive CLI Features

Many commands support interactive mode. If you omit required arguments, the CLI can guide you with step-by-step prompts and selection menus.

# Prompts for API token input
podstack auth login

# Interactive project creation wizard
podstack project create

# Interactive pod creation wizard
podstack pod create

# Interactive bucket creation/upload
podstack bucket create
podstack bucket upload

# Interactive volume workflows
podstack volume create
podstack volume resize

Installation

# macOS
brew install podstack/tap/podstack-cli

# Linux
curl -sSL https://get.podstack.ai/cli | bash

# Windows
winget install podstack.cli

In This Section

Common Commands

Support

For CLI issues, visit Customer Support or check the Troubleshooting guide.