Configuration

Most behaviour is controlled by explicit CLI flags. Runtime configuration uses environment variables for process context, tracked application config files, and private YAML files for git/GitHub repo tracking and optional dashboard source cards.

Environment VariablesAll DOT_*, DOTFILES_*, and OMARCHY_* options.

Private Git ConfigThe dot-git.yml schema for repo activity and notifications.

Private Dashboard ConfigThe dot-dashboard.yml schema for optional dashboard source cards.

YaziRestore the shared Yazi plugin set across devices.

PlannotatorRestore shared Plannotator review settings across devices.

LazygitRun shared repository maintenance commands from Lazygit.

CursorRestore the last window type or choose Editor and Agents explicitly.

PackagesUse the signed public repository, AUR fallback, and private packages.

Configuration policy

For dotfiles and system scripts, prefer explicit CLI flags over environment-variable toggles for runtime behaviour. Environment variables are used for standard process context (HOME, PATH, XDG_*), secrets, paths, and compatibility shims.