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, workflows, 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.

Private PackagesBuild and publish Arch packages to the private pacman repo.

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.