Dotfiles

Various scripts avilable in the Bin folder.

Uses stow (and it's glorious --dotfiles option) to manage all dotfiles.

Agent skills (Claude + Codex + Agents)

Shared skill source files live in agent-skills/_shared-skills/<skill>/SKILL.md.

Claude command shims live in agent-skills/_claude-commands/<skill>.md and are exposed through a single symlinked commands directory in claude/dot-claude/commands.

Live paths resolve to this shared location:

• ~/.claude/commands/<skill>.md -> ~/dotfiles/agent-skills/_claude-commands/<skill>.md -> ~/dotfiles/agent-skills/_shared-skills/<skill>/SKILL.md
• ~/.codex/skills/<skill>/SKILL.md -> ~/dotfiles/codex/dot-codex/skills/<skill>/SKILL.md -> ~/dotfiles/agent-skills/_shared-skills/<skill>/SKILL.md
• ~/.agents/skills/<skill>/SKILL.md -> ~/dotfiles/codex/dot-agents/skills/<skill>/SKILL.md -> ~/dotfiles/agent-skills/_shared-skills/<skill>/SKILL.md

Pi config

Pi extensions and non-secret settings are tracked in pi/dot-pi.

Live paths resolve like this:

• ~/.pi/agent/extensions/*.ts -> ~/dotfiles/pi/dot-pi/agent/extensions/*.ts
• ~/.pi/agent/settings.json -> ~/dotfiles/pi/dot-pi/agent/settings.json

Intentionally not tracked in dotfiles:

• ~/.pi/agent/auth.json
• ~/.pi/agent/sessions/
• repo-local .pi/todos/

Steps to follow to setup a new machine:

Basic Setup

• fork dotfiles
  • run macos script, restart
• Install Brew
  • install stow
• download Chrome
  • signin
  • configure sync
  • add 1password
  • set as default browser
• download Alfred
  • activate powerpack
  • turn off spotlight search
  • stow dotfile, set preferences location
 Dev Env Setup
• stow zshrc
• stow pi
• brew install hammerspoon
  • enable accessibility & start on login
  • change caps lock to control in system prefs
• brew Install Ghosty
• brew install tmux
• install ohmyzsh (get command from site)
• brew install fzf
• stow bin
  • confirm tmux sessionizer works
• brew install neovim
  • brew install lua
  • brew install node
  • start nvim and watch everything install through lazy

Misc

• brew install gh

  • gh auth login

• configure git

• SnowSQL

• Install Jump Desktop and configure it for connecting to relevant machines.

• Install and sign in to Slack

• Install Transmit for S3 file access

• Unmount installation discs and clear downloads