Environment variables

Read by OpenLoop

Variable	Effect
OPENLOOP_HOME	Relocate all global state (default ~/.openloop/): config, registry, run dir, logs, events. Useful for tests or parallel installations.

Injected into custom agent commands

When agent.type is custom, the configured command is run as sh -c '<command> "$OPENLOOP_PROMPT"' with:

Variable	Value
OPENLOOP_PROMPT	The full task prompt for this run.
OPENLOOP_MODEL	The resolved model for this run (CLI flag → project → global).

Injected into command hooks

Command hooks (config add-hook --type command …) receive the event as JSON on stdin, plus:

Variable	Value
OPENLOOP_EVENT	Event name (e.g. promotion-auto-merge-queued).
OPENLOOP_PROJECT	Project alias, when applicable.
OPENLOOP_TASK_ID	Task id, when applicable.

The legacy notifications.* shell commands receive the same environment.

See hooks & notifications for the event list and response contract.