Skip to content

CLI

The HollowHost CLI lets you manage your agents, trigger runs, view logs, and configure secrets from your terminal.

Installation

curl -L https://download.hollowhost.com/latest/hollowhost_darwin_arm64.tar.gz | tar xz
sudo mv hollowhost /usr/local/bin/

curl -L https://download.hollowhost.com/latest/hollowhost_darwin_amd64.tar.gz | tar xz
sudo mv hollowhost /usr/local/bin/

Linux

Beta

Linux builds are provided as-is and have not been extensively tested. Please report any issues.

curl -L https://download.hollowhost.com/latest/hollowhost_linux_amd64.tar.gz | tar xz
sudo mv hollowhost /usr/local/bin/

curl -L https://download.hollowhost.com/latest/hollowhost_linux_arm64.tar.gz | tar xz
sudo mv hollowhost /usr/local/bin/

Verify the installation:

hollowhost version

Authentication

Log in with your HollowHost account. This opens your browser for secure authentication via OAuth 2.0.

hollowhost login

On headless environments (SSH, CI), use --no-browser to get a URL you can open manually:

hollowhost login --no-browser

To log out and remove stored credentials:

hollowhost logout

Commands

Agents

List agents

hollowhost agents list

All commands support --output json for scripting:

hollowhost agents list -o json

Get agent details

hollowhost agents get <agent-id>

Create an agent

hollowhost agents create \
  --repo owner/repo \
  --lang python \
  --pm uv \
  --token-type NONE
Flag Required Description
--repo Yes GitHub repository (owner/repo)
--lang Yes python or typescript
--pm Yes Package manager: pip, uv (Python) or npm (TypeScript)
--token-type No CUSTOM (default), DEFAULT, or NONE
--github-token If CUSTOM GitHub personal access token
--entry-point No Entry point file (e.g. src/main.py)
--project No Project ID to assign the agent to
--follow No Watch validation progress

Deploy an agent

hollowhost agents deploy <agent-id>

# Watch the deployment in real time
hollowhost agents deploy <agent-id> --follow

Run an agent

hollowhost agents run <agent-id>

# Watch execution and display logs when done
hollowhost agents run <agent-id> --follow

Update an agent

hollowhost agents update <agent-id> \
  --name "My Agent" \
  --memory-size 512 \
  --timeout 300
Flag Description
--name Display name (max 50 chars)
--description Description (max 200 chars)
--memory-size Memory: 256, 512, or 1024 MB
--timeout Timeout: 60-900 seconds
--persistent-storage Enable persistent storage
--token-type CUSTOM, DEFAULT, or NONE
--schedule Cron expression (5 fields, e.g. "0 9 * * *")
--schedule-timezone Timezone (e.g. Europe/Paris)
--enable-schedule / --disable-schedule Toggle schedule

Delete an agent

hollowhost agents delete <agent-id>

# Skip confirmation
hollowhost agents delete <agent-id> --yes

Duplicate an agent

hollowhost agents duplicate <agent-id>

Environment variables

Import variables from a .env file. An interactive picker lets you classify each variable as an environment variable or a secret. Sensitive names (containing KEY, SECRET, TOKEN, PASSWORD, etc.) are pre-classified as secrets.

hollowhost agents env import <agent-id> --file .env

Non-interactive mode for CI/scripts:

# Specify which variables are secrets
hollowhost agents env import <agent-id> --file .env --secrets "API_KEY,DB_PASSWORD"

# All as env vars
hollowhost agents env import <agent-id> --file .env --all-env

# All as secrets
hollowhost agents env import <agent-id> --file .env --all-secrets

Note

Values are never displayed in the terminal. Only variable names are shown.

Runs

# List runs for an agent
hollowhost runs list <agent-id>

# View logs for a specific run
hollowhost runs logs <agent-id> <run-id>

Projects

hollowhost projects list
hollowhost projects create --name "My Project"
hollowhost projects rename <project-id> --name "New Name"
hollowhost projects delete <project-id> --yes

Storage

# View storage info
hollowhost storage info <agent-id>

# List files
hollowhost storage files <agent-id>

# Delete a file
hollowhost storage delete-file <agent-id> path/to/file.json

# Clear all files
hollowhost storage clear <agent-id> --yes

Shell completion

Enable autocompletion for your shell:

Add to your ~/.zshrc:

source <(hollowhost completion zsh)

Add to your ~/.bashrc:

source <(hollowhost completion bash)

hollowhost completion fish | source

Restart your shell or run source ~/.zshrc (or equivalent) for changes to take effect.

Global flags

Flag Description
-o, --output Output format: text (default) or json
-h, --help Show help for any command