# Herald OS settings that come from the environment. All are optional and the defaults suit most
# people, so every line here is commented out.
#
# Nothing loads this file automatically:
#   macOS: export the variables you want before `npm run dev` (or `npm start`).
#   Linux: copy the lines you want into ~/.config/herald-os/session.env, then
#          `sudo systemctl restart greetd`.
#
# Never put credentials here. Hermes Agent keeps API keys and logins in ~/.hermes (run `hermes setup`
# or open Settings in Herald OS), and the shell never needs them.
#
# Names written before the rename (HERMES_OS_*) are still read.

# ---- Shell window ----

# Kiosk window: no way to leave fullscreen.
# HERALD_OS_KIOSK=1

# Start windowed instead of fullscreen.
# HERALD_OS_WINDOWED=1

# Page zoom for the whole shell.
# HERALD_OS_ZOOM=1.25

# desktop (one window, the default) or panels (one window per surface, used by the niri session).
# HERALD_OS_SHELL_MODE=desktop

# ---- Hermes backend ----

# Hermes Agent checkout to run `hermes serve` from (default: ~/.hermes/hermes-agent).
# HERALD_OS_HERMES_ROOT=/path/to/hermes-agent

# Working directory for new sessions (default: your home folder).
# HERALD_OS_DEFAULT_CWD=/path/to/projects

# Turn off the herald-os-bridge plugin (desktop tools, UI control) without uninstalling it.
# HERALD_OS_BRIDGE_DISABLED=1

# Hermes home, if not ~/.hermes. Read by Hermes itself, the shell and the bridge.
# HERMES_HOME=/path/to/.hermes

# ---- Development ----

# Load the renderer from a Vite dev server instead of the built files. `npm run dev` sets this.
# HERALD_OS_DEV_SERVER=http://127.0.0.1:5180

# Chrome DevTools protocol port, for scripted checks.
# HERALD_OS_REMOTE_DEBUG_PORT=9333

# ---- Linux session (session.env) ----

# Compositor: niri (panels, the default) or cage (one fullscreen window).
# HERALD_OS_COMPOSITOR=niri

# Run niri nested inside another Wayland session: 0, 1 or auto.
# HERALD_OS_NIRI_NESTED=auto

# Display scale for HiDPI screens (1.5 for 2048x1280, 2 for 2880x1800): niri's output scale, or
# the page zoom under cage.
# HERALD_OS_SCALE=1.5

# Lock the screen, then turn it off, after this many idle seconds.
# HERALD_OS_LOCK_AFTER=600
# HERALD_OS_SCREEN_OFF_AFTER=900

# Software rendering. Turned on automatically when there is no GPU render node (most VMs).
# HERALD_OS_SOFTWARE_GPU=1

# Disable Chromium's sandbox, only if user namespaces are unavailable.
# HERALD_OS_NO_SANDBOX=1

# Alternate shell build, or Electron binary.
# HERALD_OS_APP=/path/to/apps/desktop
# HERALD_OS_ELECTRON=/path/to/electron

# Checkout that herald-os-update pulls from (default: ~/Herald-OS).
# HERALD_OS_REPO=/path/to/Herald-OS