Personal Arch Linux configuration for the owner's workstations and headless hosts, managed in place from a synced checkout by setup.sh and verified by bin/dotfiles-health. It links shell, Neovim, kitty, tmux, Niri, Noctalia, systemd user units, and per-host state while keeping high-churn and machine-local files out of sync.
Authority: docs/setup.md, docs/development.md, docs/desktop-themes.md
This is the owner's Arch Linux configuration, with headless and platform variants. A clone supplies tracked configuration; sibling tools and private host state are separate prerequisites. Start with host setup and its read-only preflight. Run installation only from the approved main checkout. For an isolated code worktree, follow development instead.
just setup-dry-run # preview headless link-only installation
just health # inspect host links/config without systemd queries
just health-systemd # include user timer state
just docs # regenerate root identity regions
just check-hygiene # source and local record checksAutomatic broad tests are disabled by the validated local policy; a skip is not a pass. Use focused checks for changed behavior. See development for deliberate full verification, portable CI and its limits.
| Reference | Covers |
|---|---|
| Setup | Prerequisites, phases, generated state and service gates |
| Development | Worktrees, focused checks, CI and doc maintenance |
| Desktop themes | Palette fields, promotion and reader behavior |
| Capture hosts | Explicit sudoers grants and revocation |
| Git indexes in Dropbox | Native rules, migration and recovery |
| Fresh-install hardening | Storage, boot, keymap, fan and SSH procedures |
| Host CPU budget | Opt-in agent scopes and declared host policy |
| Mindful runtime | Release launchers, phone access, backups and rollback |
setup.sh,install.toml,install-linux.toml,install-graphical.toml,lib/— host installation and declarative links.bin/— health, layout, theme, desktop and application commands.shell/,nvim/,kitty/,ghostty/,git/,tmux.conf— shell, editor, terminal and Git configuration; shell sources hold the alias/function catalogue.niri/,noctalia/,prism/,wali/,systemd/— desktop configuration, per-host theme inputs and service sources.cheatsheets/— functional command references, opened through shell helpers.docs/— current subject references;tests/holds verification,scripts/the repository's gates and maintenance scripts, andtools/vendored shared tooling.
Neovim's science-project Markdown integration loads ~/d/science-md.nvim as an
external plugin checkout. Its implementation and development history belong there;
the local plugin declaration is in nvim/lua/user/plugins/lang.lua.
Workstations and headless hosts link home/config paths into this checkout and use
bin/dotfiles-health to inspect installed state. Whole-directory links make
configuration edits immediately live; merging a branch can require host approval.
Setup and user units connect sibling lookout, Prism, Familiar, Wali and Resource Pressure Alert installations. Ops and hostkit own shared tooling and storage/link primitives. Each sibling owns its own source, installation and runtime contracts.