CLI Reference

Complete documentation for all hessian CLI commands. Pages under this section are auto-generated from the cobra command tree by make gen-cli-docs.

For a conceptual overview of contexts, profiles, and the credentials file, see the CLI guide.

Available Commands

Authentication

• hessian login - Authenticate with Hessian (writes to the active profile)

Configuration

• hessian config - Manage Hessian CLI configuration
• hessian config context - List or switch the active context
• hessian config add-context - Create a new context
• hessian config delete-context - Delete a context
• hessian config header - Manage per-profile request headers
• hessian config header add - Add or replace a header on a profile
• hessian config header list - List headers configured on a profile
• hessian config header remove - Remove a header from a profile

Worker Management

• hessian worker - Worker command group
• hessian worker start - Start a worker
• hessian worker list - List available workers
• hessian start - Start the worker as a background service
• hessian stop - Stop a running background worker

Global Flags

All commands support these global flags:

Configuration

The CLI reads configuration from two files in ~/.hessian/:

• config.yaml — global CLI prefs (currently just current_context)
• credentials — INI file holding every named profile (mode 0600)

Environment variables prefixed HESSIAN_ override profile values:

export HESSIAN_API_URL=https://api.hessian.sh   # or HESSIAN_API_HOST
export HESSIAN_API_KEY=wtp_...
export HESSIAN_TOKEN=eyJ...
export HESSIAN_PROFILE=nonprod                  # selects the active profile

For the full resolution order and worked examples, see the CLI guide.