Skip to content
All You Need Is Git

Environment Variables

AYNIG exposes commit metadata to commands via environment variables.

Common variables:

  • BODY — the commit message body (prompt)
  • COMMIT_HASH — the triggering commit hash
  • LOG_LEVEL — resolved log level for the run/branch
  • ROLE — selects .aynig/roles/<role>/command when set
  • STDOUT_LOG_PATH — absolute path to the stdout log file for this run
  • STDERR_LOG_PATH — absolute path to the stderr log file for this run
  • WORKTREE_PATH — absolute path to the worktree used for this command run

Precedence: --log-level > dwp-log-level trailer > LOG_LEVEL env.

Trailers are also exposed as environment variables:

  • trailer key foo: bar → FOO=bar
  • trailer key baz: qux → BAZ=qux

Implementation note: keys are uppercased and normalized for shells. Trailer-derived variables are skipped when they would overwrite an existing or reserved env var such as PATH, HOME, BODY, STDOUT_LOG_PATH, STDERR_LOG_PATH, or ROLE.