dotfiles

ryoppippi's dotfiles, managed as a Nix flake: nix-darwin plus Home Manager on macOS, standalone Home Manager on Linux.

Layout

• flake.nix — inputs, apps, treefmt, and the darwin/home configurations
• nix/modules/home/ — cross-platform Home Manager modules (packages, programs, dotfile symlinks)
• nix/modules/darwin/ — macOS system settings, Homebrew, OmniWM
• nix/modules/linux/ — Linux-only modules
• nix/overlays/ — custom packages, also exposed as flake packages
• nix/packages/node/ — Node packages built with Nix
• fish/, nvim/ — plain config, symlinked into place by Home Manager
• agents/skills/, agents/shared/ — skills and instruction fragments shared by Claude Code and Codex
• registry/sources/ — pinned external skill repositories

Setup

macOS

1. Install Nix:

   curl -sSfL https://artifacts.nixos.org/nix-installer | sh -s -- install --enable-flakes
   

2. Clone with ghq:

   nix shell nixpkgs#ghq nixpkgs#git --command ghq get github.com/ryoppippi/dotfiles
   cd "$(nix shell nixpkgs#ghq --command ghq root)/github.com/ryoppippi/dotfiles"
   

3. Sign in to the Mac App Store (open -a "App Store") so masApps can install.

4. Apply the configuration. This also installs Homebrew:

   sudo xcodebuild -license accept
   nix --accept-flake-config run .#switch
   exec fish
   

Linux

curl --proto '=https' --tlsv1.2 -sSf -L https://install.nixos.org | sh -s -- install
nix shell nixpkgs#ghq nixpkgs#git --command ghq get github.com/ryoppippi/dotfiles
cd "$(nix shell nixpkgs#ghq --command ghq root)/github.com/ryoppippi/dotfiles"
nix run .#switch

GitHub API rate limit

If Nix hits the GitHub API rate limit, load a token into GITHUB_TOKEN from a credential helper or password manager, then retry. Never paste the token into the command line or commit it.

NIX_CONFIG="access-tokens = github.com=$GITHUB_TOKEN" \
  nix --accept-flake-config run .#switch

Daily Usage

Flakes only see tracked, staged files, so git add changed paths before switching.

Scheduled GitHub Actions open PRs for flake inputs, overlays, node packages, and skill pins.

Window Management

See the OmniWM configuration and keyboard workflow.

Stats