dotfiles

Setup guide is here: setup-mac.md

• Shell: zsh
  • Package manager: Nix (nix-darwin + home-manager)
• Terminal: Ghostty
• Editor: Neovim
• Font: Menlo + Hiragino Kaku Gothic ProN (Ghostty); Nerd Fonts (Hack, JetBrains Mono) are installed by Nix

Shell for humans and AI agents

AI agents (Claude Code, Codex, ...) now run more commands in this shell than I do, so the shell is plain by default and human UX is opt-in.

• .zshenv defines is_human: true only when stdin/stdout are a TTY and no agent marker (CLAUDECODE, AI_AGENT, ...) is set
• Agents get plain zsh: no aliases (cp -i, rm → trash, ls → eza), no fzf-driven cd, EDITOR=true and PAGER=cat, so nothing waits for input
• .zshrc returns early unless is_human; below that line come aliases, plugins, prompt, keybinds and setopts

Export AI_AGENT=1 to force the agent side.

Packages

Everything is declared in the flake and installed by darwin-rebuild switch:

• CLI tools, zsh plugins, fonts and most GUI apps: Nix
• Mac App Store apps: mas, from the list in app-store.nix
• Vendor apps that update themselves or install system components (1Password, Chrome, Docker, ...): Homebrew casks in homebrew.nix, used only to install them

Nothing is pinned for App Store or vendor apps; only a missing app is installed.

Two Macs share this flake: pro23 (private) and PC-M-2025-026 (work). darwin-rebuild picks the configuration by scutil --get LocalHostName; anything outside nix/hosts/ applies to both.

flake.nix              # one darwinConfiguration per hostname
nix/
  darwin.nix           # system settings shared by all Macs
  macos.nix            # macOS System Settings (Dock, Finder, trackpad, Touch ID sudo)
  homebrew.nix         # vendor apps installed by Homebrew
  hosts/<hostname>.nix # per-machine packages, casks and App Store apps
  home/
    dotfiles.nix       # links the files in home/ into ~
    env.nix            # my.env: variables for every shell, agents included
    human.nix          # my.human: aliases, plugins and env for humans only
    mas.nix            # my.masApps: Mac App Store apps to install
    skills.nix         # my.skills: Agent Skills shipped with tools
    tools/<tool>.nix   # one file per tool: its package and its shell settings
home/                  # files linked into ~ under the same names (nix/home/dotfiles.nix)
  .zshenv, .zshrc, .zsh/ # hand-written zsh
  .gitconfig, bin/, ...
  .claude/             # Claude Code user settings, linked into ~/.claude
  .config/             # linked to ~/.config as a whole (by activation, see dotfiles.nix)
docs/                  # setup guide (setup-mac.md) and images

Each file in nix/home/tools/ is imported automatically. It installs a tool and puts its human-only settings in my.human, which is rendered into ~/.config/zsh/human.zsh and sourced after the is_human guard. Deleting the file removes both the tool and its settings.

# nix/home/tools/eza.nix
{ pkgs, ... }:
{
  home.packages = [ pkgs.eza ];
  my.human.aliases.ls = "eza --group-directories-first";
}

My own tools (e.g. naminator) are published to babarot/nur-packages by GoReleaser on each release.

Agent Skills for Codex and other agents come from babarot/agent-skills (private, fetched over SSH) and are linked into ~/.agents/skills. Claude Code gets the same skills from the plugin marketplace.

Apply changes

sudo darwin-rebuild switch --flake ~/src/github.com/babarot/dotfiles

New files must be tracked by git (git add) before Nix can see them.

Update packages

nix flake update           # everything
nix flake update babarot   # only my own tools

After nix flake update agent-skills, run nix build ".#darwinConfigurations.$(scutil --get LocalHostName).system" --no-link as yourself before sudo darwin-rebuild, since root has no SSH key for the private repo.