Asgard EHS

Open-source compliance tools for EHS professionals. Local-first, single-binary Go applications that work standalone or as an integrated ecosystem.

---

Project maintained by asgardehs Hosted on GitHub Pages — Theme by mattgraham

Back to Heimdall docs

CLI Reference

The Heimdall CLI provides direct access to the config store from the terminal. All commands are under the config subcommand.

config get

Retrieve a single config value.

heimdall config get <namespace> <key>

Example

$ heimdall config get muninn vault_path
muninn.vault_path = /home/you/.local/share/muninn (source: default, type: path)

Secrets are masked:

$ heimdall config get ai api_key
ai.api_key = sk-a...xyz9 (source: user, type: secret)

---

config set

Write a config value. Validates against the schema if one exists.

heimdall config set <namespace> <key> <value>

Examples

$ heimdall config set ai provider anthropic
ai.provider = anthropic

$ heimdall config set ai enabled true
ai.enabled = true

$ heimdall config set ai provider invalid
Error: validation failed: value "invalid" not in allowed choices [anthropic openai]

---

config list

List all config entries for a namespace.

heimdall config list <namespace>

Example

$ heimdall config list ai
  enabled      = false       (default)
  provider     = anthropic   (user)
  api_key      = sk-a...xyz9 (user)
  odin_access  = []          (default)
  muninn_access = []         (default)
  huginn_access = []         (default)

---

config reset

Reset a config key to its schema default.

heimdall config reset <namespace> <key>

Example

$ heimdall config reset odin theme
odin.theme reset to default.

Returns an error if no schema default exists for the key.