CLI Reference
CLI for the Greyhound deployment control plane
Prerequisites
ghCLI authenticated with access to the Underdog-Inc GitHub org
Installation
The install script downloads a standalone binary — no Node.js required.
gh api repos/Underdog-Inc/greyhound/contents/cli/install.sh -H "Accept: application/vnd.github.raw+json" | bash
The binary is installed to ~/.local/bin/greyhound. If ~/.local/bin is not in your PATH, add it:
# Add to your ~/.zshrc or ~/.bashrc
export PATH="$HOME/.local/bin:$PATH"
Verify the installation:
greyhound --version
Pin a specific version
VERSION=cli-v0.1.0 gh api repos/Underdog-Inc/greyhound/contents/cli/install.sh -H "Accept: application/vnd.github.raw+json" | bash
Install to a custom directory
INSTALL_DIR=/usr/local/bin gh api repos/Underdog-Inc/greyhound/contents/cli/install.sh -H "Accept: application/vnd.github.raw+json" | bash
Upgrading
Re-run the install command to upgrade to the latest version. The binary will be overwritten in place.
Uninstalling
rm ~/.local/bin/greyhound
Global Options
These options apply to all commands.
| Flag | Description | Default |
|---|---|---|
-V, --version | output the version number | - |
--api-url <url> | Greyhound API URL (default: GREYHOUND_API_URL env var, or https://greyhound-api.prod.underdog.tools) | - |
--refresh | Bypass server-side permission cache | - |
Environment Variables
| Variable | Description |
|---|---|
GREYHOUND_API_URL | API URL (overridden by --api-url flag) |