CLI Reference
CLI Reference
Install and use the Hogsend CLI to deploy, configure, and manage lifecycle engine instances from your terminal.
Overview
The Hogsend CLI is a per-project setup and management tool. It connects to your Railway deployment, configures PostHog webhooks, manages contacts, and lets you test the full event pipeline without leaving your terminal.
Installation
Download the latest release for your platform:
macOS (Apple Silicon)
curl -fsSL https://github.com/hogsend/cli/releases/latest/download/hogsend-darwin-arm64.tar.gz \
| tar xz -C /usr/local/binmacOS (Intel)
curl -fsSL https://github.com/hogsend/cli/releases/latest/download/hogsend-darwin-amd64.tar.gz \
| tar xz -C /usr/local/binLinux (arm64)
curl -fsSL https://github.com/hogsend/cli/releases/latest/download/hogsend-linux-arm64.tar.gz \
| tar xz -C /usr/local/binLinux (amd64)
curl -fsSL https://github.com/hogsend/cli/releases/latest/download/hogsend-linux-amd64.tar.gz \
| tar xz -C /usr/local/binVerify the installation:
hogsend --versionCommands
| Command | Description |
|---|---|
hogsend init | Configure a deployment after Railway template deploy |
hogsend setup | Set up the local development environment |
hogsend status | Check health of the current deployment |
hogsend deploy | Trigger a Railway redeploy for API + Worker |
hogsend test | Send a test event and verify the pipeline |
hogsend journeys | Manage which journeys are active |
hogsend contacts | List, create, update, and delete contacts |
hogsend destroy | Tear down the Railway project |
Configuration
All commands read from .hogsend.yaml in the current directory. This file is created by hogsend init (for production deployments) or hogsend setup (for local development) and stores:
- Project name and slug
- Railway project ID, environment ID, service IDs, domain, and API token
- PostHog project ID, API keys, host, and webhook destination ID
- Enabled journeys list
- Admin API key
The file contains secrets (Railway token, PostHog keys, admin API key). Add .hogsend.yaml to your .gitignore.