Skip to content
khughittPublic

About

My dotfiles.

Resources

Stars

23 stars

Watchers

1 watching

Forks

Latest commit

 

History

1,923 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dotfiles

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

Setup

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.

Usage

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 checks

Automatic 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

Layout

  • 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, and tools/ 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.

Consumers

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.

About

My dotfiles.

Resources

Stars

23 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages