Skip to main content
The InstaPods CLI (instapod) is a Go binary that lets you manage pods, files, services, and more from your terminal. It’s designed for developers and AI agents.

​
Install from Source

go install github.com/instapods/v2/cli@latest
Or build locally: 
git clone https://github.com/instapods/v2.git
cd v2
go build -o instapod ./cli/
Move the binary to your PATH: 
mv instapod /usr/local/bin/

​
Verify Installation

instapod --help

​
Configuration

The CLI stores its configuration at ~/.instapods/config.json: 
{
  "token": "your-auth-token",
  "api_url": "https://api.instapods.com",
  "team_id": "your-team-id"
}

​
API URL Priority

The CLI resolves the API URL in this order:
  1. --api flag (e.g., instapod --api http://localhost:7070 pods list)
  2. INSTAPOD_API environment variable
  3. Value from ~/.instapods/config.json
  4. Default: http://localhost:7070

​
Global Flags

FlagDescription
--apiOverride the API URL
--jsonOutput in JSON format

​
Shell Completion

The CLI supports shell completion for bash, zsh, fish, and PowerShell: 
# Bash
instapod completion bash > /etc/bash_completion.d/instapod

# Zsh
instapod completion zsh > "${fpath[1]}/_instapod"

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

​
Next Steps