This is my terminal. There are many like it, but this one is mine. My terminal is my best friend. It is my life. I must master it as I must master my life. Without me, my terminal is useless. Without my terminal, I am useless.
My various configuration files to make ${HOME} home.
| Path | Command | Needs |
|---|---|---|
| CLI, no root (headless/remote) | curl -sSL https://raw.githubusercontent.com/cacack/dotfiles/main/install.sh | bash |
zsh, make, stow, git, curl, tar, unzip already installed |
| CLI, with root | same command | sudo or root; installs whatever of the above is missing |
| Full desktop | same command with | bash -s -- --desktop |
macOS: Command Line Tools (Homebrew goes to ~/.local/opt/homebrew without admin); Linux: sudo for GUI apps, plus libatomic |
- CLI runs
make install: stows configs and installs the light tool set (shell utilities, prompt, tmux, Neovim with binary-only language servers; no language runtimes, nothing compiled). Nothing needs root. Without root or sudo,install.shlists any missing prerequisites for an admin to install. - Desktop runs
make desktop: the CLI install plus the heavy tool set (Go, Node, Python, Ruby, Rust, cloud CLIs, Bitwarden CLI, …, plus Neovim's full language servers), fonts, GUI apps and OS settings.
Supported platforms: macOS (Apple Silicon), Ubuntu/Debian, Fedora/RHEL, Arch, openSUSE (x86_64 and arm64)
Then change shells to zsh:
chsh -s "$(command -v zsh)"Without chsh rights (e.g. directory-managed accounts), add this to ~/.bash_profile instead:
[ -x "$(command -v zsh)" ] && exec zsh -lLog out and back in to activate the new setup (zinit will install plugins automatically).
📖 For detailed setup instructions and troubleshooting, see docs/BOOTSTRAP-MACOS.md
git clone https://github.com/cacack/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
make install # CLI
make desktop # or: full desktopCLI tools and language runtimes are installed by mise. Every version is pinned exactly and locked, with per-platform checksums:
configs/.config/mise/config.toml→mise.lock: light tools (every install)configs/.config/mise/config.desktop.toml→mise.desktop.lock: heavy tools (language runtimes and what needs them)
make desktop (and make install-desktop) records the machine's profile in
~/.config/dotfiles/mise-env (MISE_ENV=desktop); Neovim reads the same flag
to pick its language servers (lua/configs/tools.lua). Without it a machine is
light: desktops set up before mise must run make desktop once, or they lose
their runtimes, cloud CLIs and GUI app updates on the next make update.
Renovate opens pull requests to bump the pins. Bumps it tracks through its mise
support arrive with the lockfiles updated and pass the mise-lock CI job as-is.
Two kinds fail it until make mise-lock is run on the branch and the lockfiles
committed: tools tracked by a custom rule in renovate.json (gcloud), whose
bumps change only the config, and security fixes edited into a Python tool's
uv.lock, which leave its checksum in the lockfile stale.
make tools # install exactly what the lockfiles pin (also part of `make update`)
make mise-lock # regenerate both lockfiles after editing a config; commit them together
make security # scan the pinned tools for known vulnerabilitiesEach layer catches what the others miss:
| Layer | Guards against | Where |
|---|---|---|
| Exact pins + per-platform checksums | a tampered or swapped download | mise.lock, locked = true |
| Shell plugins, Oh My Zsh and zinit pinned to commits | a malicious push to a plugin repo reaching every shell | _zinit_pins in configs/.zshrc.d/00_init.zsh |
| Signed provenance re-verified on install (GitHub attestations, SLSA, cosign) where upstream publishes it | a release not built by the project's CI | locked_verify_provenance in config.toml |
| 7-day minimum release age (vulnerability fixes exempt) | a compromised release, usually yanked within days | renovate.json |
| Lockfile check on every pull request | a bump that skips the lock | mise-lock CI job |
| osv-scanner on the Python and npm tools' locked dependencies | known-vulnerable transitive packages | make security-deps, CI on pull requests + weekly |
| Trivy on everything installed (HIGH/CRITICAL with a fix) | vulnerable Go modules, bundled npm/gems/Python packages | make security-tools, CI on pull requests + weekly |
Accepted findings live in .osv-scanner.toml and .trivyignore.yaml, each with a
reason and an expiry date, so they come back for review. CI is
.github/workflows/supply-chain.yml; the weekly scans run on its schedule.
Shared git hooks block private terms (employer names, internal hosts and the
like) from public repos. ~/.gitconfig enables them only for repos with a
remote under github.com/cacack or gitlab.com/cacack, by including
~/.config/git.d/public-repo, which sets core.hooksPath.
- The term list is extended regexes, one per line, matched case-insensitively,
at
~/.config/git-private-terms(or$GIT_PRIVATE_TERMS). Keep it out of this repo; with no list, the hooks warn and skip. pre-commitchecks staged file names, contents and the author and committer;commit-msgthe message;pre-pushevery pushed commit.- The hooks then run the repo's own
.git/hooks/<name>, whichcore.hooksPathwould otherwise bypass. - Output names only the file and line of a match, never the term. In CI
(
CIset), a path that itself matches prints as<redacted path>. - CI (
.github/workflows/private-terms.yml) runs the same check from thePRIVATE_TERMSrepository secret. Keep it in step with the local list.
- GUI applications and system settings: See
docs/GUI-APPS-AND-SETTINGS.md - Work-specific configs: Create
~/.zshrc_work.d/directory - Secrets: Create
~/.zshrc_secrets.d/directory
Copyright (c) 2024, Chris Clonch. Distributed under an MIT License.