Stockyard CLI

Install, start, stop, and manage all 150 Stockyard tools from your terminal.

Installation

curl -fsSL https://stockyard.dev/cli/install.sh | sh

Linux and macOS. amd64 + arm64. ~5MB binary, zero dependencies.

Or download directly from GitHub Releases.

Quick Start

# Install some tools
stockyard install corral paddock saltlick

# Start them all
stockyard start --all

# Check status
stockyard status

# Set your license key (applies Pro to every tool)
stockyard license set SY-xxxxx
stockyard restart --all

Commands

Command	Description
stockyard install <tool...>	Install one or more tools from GitHub Releases
stockyard install --all	Install all 150 tools
stockyard uninstall <tool>	Remove a tool
stockyard start <tool>	Start a tool as a background process
stockyard start --all	Start all installed tools
stockyard stop <tool>	Stop a running tool (SIGTERM, then SIGKILL)
stockyard stop --all	Stop all running tools
stockyard restart <tool>	Stop and start a tool
stockyard status	Show all installed tools with status
stockyard status <tool>	Show detailed status and health for one tool
stockyard update <tool>	Re-download the latest version
stockyard update --all	Update all installed tools
stockyard list	List all 150 available tools by category
stockyard list --installed	List installed tools only
stockyard list --running	List running tools only
stockyard search <query>	Search tools by name or description
stockyard logs <tool>	View recent logs for a tool
stockyard license set <key>	Save your license key
stockyard license show	Show current license
stockyard config	Show configuration
stockyard version	Show CLI version

Configuration

All config lives in ~/.stockyard/:

~/.stockyard/
  config.json          # license key, ports, settings
  bin/                 # installed tool binaries
  tools/               # metadata for each installed tool
  logs/                # stdout/stderr from managed tools
  data/                # data directories for each tool

The license key is stored in config.json and passed to every tool via the STOCKYARD_LICENSE_KEY environment variable when starting. Set it once, every tool gets Pro.

How It Works

Install downloads the tool binary from GitHub Releases, extracts it from the tar.gz archive, and places it in ~/.stockyard/bin/. Each tool gets a metadata file tracking its version, port, and data directory.

Start runs the tool as a background process with PORT, DATA_DIR, and STOCKYARD_LICENSE_KEY environment variables set. Stdout and stderr are captured to log files. The CLI waits 2 seconds and hits /health to verify the tool started successfully.

Stop sends SIGTERM and waits up to 5 seconds for graceful shutdown. If the process doesn't exit, it sends SIGKILL.

Ports are assigned from the tool's default port. If a port is already in use, the CLI auto-increments to find an open one.

← Ops Guide API Reference →