shielded-cli

A simple CLI for interacting with the shielded.dev service.

Install

npm install -g shielded-cli

Usage

# Update one shield with its own API token.
export SHIELDED_TOKEN="<Your token from shielded.dev>"

shielded --title "Last Build" --text "$(date)" --color "00AA33"

For a one-off command, pass the token directly with --token. An explicit --token always wins over environment variables.

shielded --token "<Your token from shielded.dev>" --title "Last Build" --text "$(date)" --color "00AA33"

Update shields by key

A user API token can update or create any of your shields. Give the shield a stable key with --key, then keep the user token in SHIELDED_USER_TOKEN:

export SHIELDED_USER_TOKEN="sdu_<your user API token>"

shielded --key "production-status" --title "Last Build" --text "$(date)" --color "00AA33"

When you use --key, the CLI prefers SHIELDED_USER_TOKEN and falls back to SHIELDED_TOKEN if it is unset. Without --key, it uses only SHIELDED_TOKEN, so your existing per-shield-token commands keep working as before. An explicit --token takes precedence in either workflow.