dotfiles

Personal configs. Linux and macOS support.

Generally biased for Pop!OS 24.04 / COSMIC (for code-as-config: settings, keybinds, and extras).

Quickstart

Install prerequisites on Pop!OS (macOS already includes Zsh; install Apple Command Line Tools with xcode-select --install if Git is missing):

sudo apt update && sudo apt install -y ca-certificates curl git zsh imagemagick

Install chezmoi, clone, and inspect:

sh -c "$(curl -fsLS https://get.chezmoi.io)" -- -b "$HOME/.local/bin" init https://github.com/CSRessel/dotfiles.git && "$HOME/.local/bin/chezmoi" status

Enter Git email and select optional modules when prompted; none are enabled by default. The checkout is ~/.local/share/chezmoi, local configuration is ~/.config/chezmoi/chezmoi.toml.

Overview

The shared base includes Zsh, Bash fallback, Git, tmux, explicit tool shortcuts and aliases, plus standalone app configs for Ghostty, Kitty, LunarVim, VS Code, Zed, marimo, Tridactyl, NetHack, Nix, Claude and Codex. These configs are applied even when the app is absent; they do not install it. Modules keep system settings, installers and dictation opt-in. The optional dev-tools module provides a global mise configuration and shared shell integration.

Zed includes shared editor defaults and the Nori Green theme. Applying merges those defaults into local settings while preserving unrelated values such as SSH connections and model choices; JSONC comments and formatting are not preserved. Other Nori Green theme snapshots are kept as backups for reuse in other apps. The optional de-macos module also manages AeroSpace.

For initial checkout, compose desired modules with chezmoi init and then review the diff. Change later selections with chezmoi edit-config

Catppuccin for tmux is cloned to ~/.config/tmux/plugins/catppuccin/tmux by chezmoi apply, using the release pinned in run_after_install_tmux_theme.sh. The script only clones when the directory is missing; existing checkouts are left alone. The managed ~/.tmux.conf loads it with the Mocha flavor and basic window styling. Reload an existing session with tmux source-file ~/.tmux.conf (or tx source-file ~/.tmux.conf when using the tx alias). To upgrade, update the script's release tag for future installs and use git fetch --depth 1 origin tag <version> followed by git checkout <version> inside the existing theme checkout.

Docs

• Module settings overview
• Expected packages and defaults
• Development tools and environments
• Checks and contributing

Philosophy

1. Maximize consistency everywhere
2. Minimize future cost to revise

Rules

• For aliases, use a prefix of the command when possible.
  • If you're ever in an unsupported environment, muscle memory is still consistent with the default tooling (Consistency)
  • If you ever revise your aliases or resolve a collision then you can still retain any existing muscle memory (Revision Cost)
• Satisfy all tooling with only terminal + browser, if possible.
  • Fewer applications means fewer configs to update (Revision Cost) and less config drift (Consistency)
  • Proprietary tools will phase in and out of use, meaning configs break over time
• Write everything twice, automate on thrice
  • If it's not automated, it's not likely to stay up-to-date (Consistency)
  • And if it's manual to make updates across environments, it's honerous to change (Revision Cost)
  • (However, automation used less than yearly is the worst of all worlds)