Dotfiles

Cross-platform Nix + Home Manager dev environment.

• macOS: nix-darwin + Home Manager
• Linux remotes: standalone Home Manager
• Remote dev: Tailscale SSH + Herdr-first project sessions

Install / update

# macOS fresh install
curl -fsSL https://raw.githubusercontent.com/psteinroe/dotfiles/main/bootstrap.sh | bash

# Linux remote fresh install
curl -fsSL https://raw.githubusercontent.com/psteinroe/dotfiles/main/bootstrap-remote.sh | bash

# Update an existing machine
rebuild

Manual builds:

# macOS
nix run nix-darwin -- switch --flake ~/Developer/dotfiles#psteinroe

# Linux remote
nix run nixpkgs#home-manager -- switch --flake ~/Developer/dotfiles#psteinroe@linux-x86_64

The bootstrap and nix-darwin configuration manage Determinate Nix's /etc/nix/nix.custom.conf. It trusts Numtide's binary cache for prebuilt llm-agents.nix packages such as Pi, tuicr, and Herdr while leaving arbitrary flake configuration untrusted.

Daily project workflow

One project/repo maps to one Herdr named session. One Git worktree maps to one Herdr workspace.

hdev dotfiles main       # local Herdr session/workspace
rdev hellomateo main     # remote Herdr over Tailscale
hellomateo main          # shortcut for hdev hellomateo main
rhellomateo main         # shortcut for rdev hellomateo main

Remote defaults:

• rdev → Tailscale SSH as psteinroe
• rdev-exe → exe.dev SSH fallback as exedev
• Worktrees stay at ~/Developer/<repo>.git/<worktree>

Moshi mobile access

Home Manager installs Mosh and a pinned moshi-hook, runs the hook as a persistent systemd user service, and exposes the managed Herdr sessions to Moshi. For the primary mobile connection, install Tailscale on the phone and use:

• Host: psteinroe-dev.tail6aabd2.ts.net
• Port: 22
• User: psteinroe
• Connection type: Mosh or Auto

As psteinroe, run the following and scan its Easy Pair QR in Moshi:

moshi-hook host setup \
  --host psteinroe-dev.tail6aabd2.ts.net \
  --user psteinroe

The exe.dev SSH configuration accepts the generated key from ~/.ssh/authorized_keys, and the Mosh server is exposed on the non-interactive SSH path. Agent notification pairing remains a one-time secret-bearing step:

moshi-hook pair --token <token-from-Moshi> --store file
systemctl --user restart moshi-hook

The public exe.dev route remains an SSH-only fallback: connect to psteinroe-dev.exe.xyz as exedev and force SSH because the gateway does not proxy Mosh UDP traffic. Global Herdr and moshi-hook bridges transparently run those integrations as psteinroe on that fallback connection.

Project shortcuts follow the same local/remote pattern: dotfiles / rdotfiles, hellomateo / rhellomateo, ceplatform / rceplatform, radiomarl / rradiomarl, ninjascale / rninjascale, sbch / rsbch, pgls / rpgls, pgconductor / rpgconductor, pgstream / rpgstream, hpgstream / rhpgstream, and toolshed / rtoolshed.

Local and remote helpers intentionally mirror each other where possible:

Local	Remote	Purpose
rebuild	rrebuild [host]	Rebuild locally / force-sync the remote checkout to its upstream and rebuild Home Manager
hdev <repo> [branch|pr]	rdev <repo> [branch|pr]	Open local/remote Herdr project session
wtclean	rwtclean <repo>	Clean integrated/stale worktrees
wtforceclean	rwtforceclean <repo>	Select and force-remove worktrees
hwtcreate <branch|pr>	rhwtcreate <repo> <branch|pr>	Ensure worktree and focus/open Herdr workspace
hsyncworktrees [--prune]	rhsyncworktrees <repo> [--prune]	Sync Git worktrees into Herdr workspaces
—	rauth [all|gh|pi|mcp|exa]	Copy local GitHub/Pi/MCP/Exa auth to the remote
—	ssh rdev-exe	Recovery path via exe.dev gateway

For the full command list, run devhelp.

Git worktrees

wtclone git@github.com:user/repo.git
cd repo.git/main
wtcreate feature-x
wtcheckout 123
wtclean

Common local commands:

Command	Purpose
wtclone <url>	Clone as bare repo plus main worktree
wtcreate <branch>	Create branch worktree
wtcheckout <branch|pr#>	Checkout branch/PR worktree
wtensure <branch|pr#>	Ensure worktree exists and cd into it

Git / PR review

Command	Purpose
review	Open tuicr for the current repo
gpd [pr]	Pipe gh pr diff into diffnav
gpr [-a] [-n] [-e] [-d] [-f issue]	Commit/push/create PR helper
`/pr [--all	-a] [--draft] [--fixes issue]`
lazygit	Terminal Git UI

diffnav is the pager for git diff; other Git commands use delta.

License

MIT