Skip to content

rbright/dotfiles

Repository files navigation

Dotfiles

This repository contains my personal dotfiles managed with GNU Stow.

⚡ Requirements

  • GNU Stow for dotfile management
  • Just command runner for installation

🚀 Installation

Install dotfiles for a specific host:

just install lambda
just install omega

just install always requires an explicit host. Supported hosts:

  • lambda (MacBook Pro)
  • omega (Desktop Workstation / NixOS)

🧭 Host Packages

Host definitions live in .stow/hosts/*.packages, one package per line. Blank lines and # comments are allowed.

This repository intentionally keeps only two hosts:

lambda.packages
omega.packages

🌍 Cross-OS Path Strategy

When config paths differ by OS (for example ~/Library/... on macOS vs ~/.config/... on Linux), use this approach:

  1. Keep truly shared configs in shared packages.
  2. Split path-specific configs into OS-specific packages (for example nushell-macos and nushell-linux).
  3. Select the correct package in each host file (.stow/hosts/*.packages).
  4. Keep machine-only secrets/keys out of shared host files unless explicitly intended.

📦 Packages

Package Description
aerospace Tiling window manager for macOS with automatic workspace management
boto AWS SDK for Python configuration
btop Terminal-based resource monitor with customizable UI
carapace Multi-shell completion framework providing completions across shells
curl Command-line tool for transferring data with URL syntax
espanso Cross-platform text expander for productivity
ghostty Modern terminal emulator with GPU acceleration
git Distributed version control system with custom aliases and GPG signing
github GitHub CLI configuration for interacting with GitHub from the terminal
gnupg GNU Privacy Guard for encryption and signing
karabiner Keyboard customizer for macOS with Vim-style navigation
macmon 🦀⚙️ Sudoless performance monitoring for Apple Silicon processors. CPU / GPU / RAM usage, power consumption & temperature 🌡️
nushell Modern shell written in Rust with structured data pipelines
neovim Hyperextensible Vim-based text editor with Lua configuration
profile Basic shell profile configuration
readline GNU Readline configuration for command-line editing
skhd Simple hotkey daemon for macOS system-wide shortcuts
starship Cross-shell prompt with Git integration and language version displays
tableplus Database GUI client with custom Catppuccin theme
tmux Terminal multiplexer with Vim-style navigation and session persistence
vnc Virtual Network Computing configuration for remote desktop
wezterm GPU-accelerated terminal emulator and multiplexer frontend
xcode Apple's IDE with custom Catppuccin Mocha color theme
zed High-performance code editor built for collaboration
zellij Terminal workspace and session manager
zsh Z shell with Oh My Zsh framework and extensive customizations

🎨 Theme

Most applications are configured with the Catppuccin Mocha color scheme for visual consistency.