-
Notifications
You must be signed in to change notification settings - Fork 0
Home
The single source of truth for the Core layer shared across every machine
in a nine-repo dotfiles system. Core is the config that is identical on every
box — zsh modules, tmux base, Neovim, git — authored once here and vendored
into each OS repo's core/ directory via git subtree.
If it changes when the operating system changes, it does not belong here. If it changes when you as an operator change, it does not belong here. Everything left over is Core, and it lives here.
This wiki is the deep-dive companion to the repo's
README: the
README tells you what Core is and how to consume it; the wiki explains how
each piece works and how to use it day to day.
Pick the path that matches why you're here.
-
Architecture & the Three-Layer Model
— Core vs OS-native vs Role, and why this uses
git subtree. - The Zsh Module System — the load-bearing module order that is the heart of Core.
-
Tools, Aliases & Functions — the modern-CLI
stack, the shell functions (
mkcd,extract,up, …), the fzf widgets, and every custom keybinding. Runcore-help(aliascheat) in any shell for the same cheat sheet live.
- Architecture & the Three-Layer Model has the "is this actually Core?" test and the subtree consumption flow.
- The repo's
CONTRIBUTING.mdandPORTING-MATRIX.mdcover the contribution bar and how to stamp a new distro.
| Layer | Lives in | Examples |
|---|---|---|
| Core | this repo, vendored into each OS repo | zsh modules, tmux base, nvim, git |
| OS-native | dotfiles-{MacBook,Debian,Fedora,Arch,…} |
package manager, clipboard, paths |
| Role | dotfiles-Kali |
engagement scaffolding, C2, wordlists |
Core is authored once here, then each machine repo pulls it in as a vendored
core/ subtree — no submodule flags, clone-and-go.
Concepts
Reference
Operating it
Project
dotfiles-core — the Core layer of
a nine-repo dotfiles system · authored once, vendored everywhere via git subtree.
Home · Architecture · Zsh · Tools · Neovim · tmux · FAQ
Source for these pages lives in
wiki/ — edit there and
sync. · core-help in any shell for the live cheat sheet.
Concepts
Reference
Operating it
Project
Repo links