@benjick/holden-cli

CLI for Holden — a self-hosted, GitOps-based container orchestrator.

Alpha — Holden is under active development. Expect breaking changes.

Install

npm install -g @benjick/holden-cli@alpha

Setup

Point the CLI at your Holden server:

holden config set server [email protected]

This fetches the server's encryption key via SSH and caches it locally for encrypting secrets.

Commands

holden vars set <key> [value]

Set a config variable or encrypted secret in holden.vars.yml.

holden vars set LOG_LEVEL debug
holden vars set API_KEY --secret sk-secret-key
holden vars set API_KEY --secret  # prompts for hidden input

holden vars get <key>

Read a config variable.

holden vars get LOG_LEVEL        # debug
holden vars get API_KEY           # [secret]
holden vars get API_KEY --show-secrets  # sk-secret-key

holden validate

Validate Holden configuration files (YAML syntax, required fields, duplicate app IDs).

holden validate

holden deploy [app]

Trigger a reconcile cycle on the server via SSH.

holden deploy          # all apps
holden deploy my-app   # specific app

holden config set/get

Manage CLI settings (server, port).

holden config set server [email protected]
holden config get server