H
HLOS Docs

CLI Reference

Complete command reference for @hlos/cli

View as Markdown

The HLOS CLI is your primary interface for managing secrets from the terminal. Install it globally with npm install -g @hlos/cli.

Global Options

--help, -hShow help for any command
--version, -vShow CLI version
--space, -sOverride the active space for this command
--quiet, -qSuppress non-essential output
hlos login

Authenticate with your HLOS account via browser OAuth.

Flags:
--no-browserPrint URL instead of opening browser
hlos logout

Clear stored credentials from your system keychain.

hlos whoami

Display the currently authenticated user email and account info.

hlos spaces list

List all spaces you have access to.

Example:$ hlos spaces list
hlos spaces create <name>

Create a new space for organizing secrets.

Example:$ hlos spaces create my-saas-app
Flags:
--description, -dAdd a description for the space
hlos spaces use <name>

Set the active space for subsequent commands.

Example:$ hlos spaces use production
hlos spaces delete <name>

Delete a space and all its secrets (requires confirmation).

hlos secrets list

List all secrets in the current space (names only, not values).

Flags:
--provider, -pFilter by provider (openai, stripe, etc.)
--jsonOutput as JSON
hlos secrets set <key>

Set a secret. Prompts for value interactively (secure input).

Example:$ hlos secrets set OPENAI_API_KEY
hlos secrets set <key> <value>

Set a secret with inline value (use with caution in scripts).

Example:$ hlos secrets set API_KEY sk-...
hlos secrets get <key>

Retrieve and display a secret value.

Example:$ hlos secrets get DATABASE_URL
hlos secrets delete <key>

Delete a secret from the current space.

hlos push

Push local .env file contents to your HLOS vault.

Flags:
--file, -fSpecify a different .env file
--mergeMerge with existing secrets instead of replacing
hlos pull

Pull secrets from HLOS to a local .env.local file.

Flags:
--output, -oSpecify output filename
hlos run -- <command>

Run a command with secrets injected into the environment.

Example:$ hlos run -- npm start
hlos sync vercel

Sync secrets to your Vercel project environment variables.

Flags:
--envTarget environment (production, preview, development)
hlos sync railway

Sync secrets to your Railway project.

hlos sync netlify

Sync secrets to your Netlify site.

hlos health

Check health status of secrets (rotation, exposure, etc.).

Flags:
--severityFilter by severity (low, medium, high, critical)
hlos audit

View recent access logs for secrets.