Configuration
Private overlay, packages, and tracked app config.
Behaviour prefers CLI flags. Environment variables cover process context and secrets. Machine-specific and private data stay in ~/.config/dotfiles-private.
| Piece | Why |
|---|---|
| Private overlay | Host-only config, secrets, package lists, browser checks, dot-git.yml |
| Public packages | apt packages listed in .dot-public-packages; command-line tools come from mise |
| Stow packages | App config in this repo; see Stow packages and the Server / Agents pages |
| Env vars | DOT_*, DOTFILES_*, and OMARCHY_HOST (host-specific packages) influence dot and session tooling |
| Private file (typical) | Role |
|---|---|
dot-git.yml |
Managed repos, shortcuts, notifications, activity, PR tracking, and OpenCode MCP opt-ins |
| Package manifests | Private install lists |
| Browser checks | Machine-specific doctor expectations |
MCP spec (mcp.yml) |
Source for dot mcp sync |
Prefer reading the stowed source and private YAML over expanding this page further. Flags and env details live in dot --help and code.