Skip to content

Environment variables

Empty values generally select defaults. Environment identity values select an existing authenticated binding; they never create authority.

Variable Purpose and default
MAJLIS_STATE_DIR Private state root; defaults to ~/.majlis. Use the same root for every entry point.
MAJLIS_WORKSPACE Workspace selection after --workspace, before discovered TOML.
MAJLIS_SESSION_FILE Exact private session marker returned by registration. If unset, the client can read <state-root>/session.json.
MAJLIS_ACTOR_ID Actor ID after the flag, before the marker value. Must match the marker.
MAJLIS_INCARNATION_ID Incarnation ID, with the same binding checks.
MAJLIS_CHECKOUT_ID Checkout ID, with the same binding checks.
MAJLIS_BINDING_TOKEN Explicit credential candidate. Prefer a private file or session marker over exporting secrets.
MAJLIS_BINDING_TOKEN_FILE Private credential file candidate.
MAJLIS_SOCKET Unix socket endpoint; beats TCP. Default <state-root>/majlis.sock. Windows rejects Unix sockets.
MAJLIS_TCP_ADDR Authenticated loopback TCP address such as 127.0.0.1:<port>. Non-loopback addresses are rejected. Default discovery reads <state-root>/majlis.port.
MAJLIS_SOCKET_PATH Hook helper compatibility alias, after MAJLIS_SOCKET.
MAJLIS_CONFIG Hook helper workspace TOML override when MAJLIS_WORKSPACE is unset.
MAJLIS_BIN Hook script executable; defaults to majlis on PATH. Use a trusted installed executable.
MAJLIS_HOOK_SPOOL Hook-gap directory override; default <state-root>/<harness>-hook-gaps.
MAJLIS_CODEX_SPOOL Codex gap directory; beats MAJLIS_HOOK_SPOOL for Codex.

MAJLIS_HOOK_PATH and MAJLIS_HOOK_PS1 are placeholders in settings templates to replace during manual installation. They are not runtime settings.

There is no MAJLIS_ADMISSION_DEFAULT policy override, and no environment switch enables consultation. No environment value grants a harness permission or accepts a review.