My dotfiles. Hope it's useful for others. Primarily using it for:
- Golang
- Ruby on Rails
- Web development in general
- Lua
- Docker
- Terraform
This repo is managed by mise dotfiles instead of GNU Stow.
home/ # files linked directly into $HOME
config/ # XDG config directories linked under ~/.config
local/bin/ # user executables linked under ~/.local/bin
macos/ # macOS-specific app config
apps/ # standalone app and extension projects
Key examples:
home/.zshrc->~/.zshrcconfig/zsh->~/.config/zshconfig/nvim->~/.config/nvimconfig/mise/config.toml->~/.config/mise/config.tomllocal/bin/dev-update->~/.local/bin/dev-updatemacos/hammerspoon->~/.hammerspoon
The full mapping is declared in config/mise/config.toml under [dotfiles].
Kitty and Kesh use the splits layout for nested right/below panes. Keep
enabled_layouts splits,stack with splits first: re-entering splits or
changing its layout options during a config reload can flatten live nested
split trees. Use Cmd+D to split right and Cmd+Shift+D to split below.
The first shell opened in a tab sets the tab title from its initial directory.
Shell title updates are disabled, and windows launched from that tab keep the
same title. Use Cmd+Shift+N to set a title manually.
Window navigation uses Ctrl+H/J/K/L for left/down/up/right. Navigation is
geometric: Ctrl+K only moves when the focused pane has another pane above it.
Preview dotfile changes:
MISE_GLOBAL_CONFIG_FILE="$PWD/config/mise/config.toml" mise dotfiles apply --dry-run --force --yes
Apply dotfiles:
make setup
Bootstrap a remote Linux machine over SSH:
cp bootstrap/.env.example bootstrap/.env
# edit bootstrap/.env and set GITHUB_USER, GITHUB_EMAIL, and GITHUB_PAT
make setup-linux HOST=hades@orb
# or
make -C bootstrap setup-linux HOST=hades@orb
This installs base packages and mise on the remote host, configures git identity, clones this repo to ~/.dotfiles over HTTPS using GITHUB_PAT without persisting the token in git config, and runs the dotfiles setup.
Check status:
MISE_GLOBAL_CONFIG_FILE="$PWD/config/mise/config.toml" mise dotfiles status
Run validation:
make test
# or
MISE_GLOBAL_CONFIG_FILE="$PWD/config/mise/config.toml" mise test
Update the full development environment (Homebrew, including auto-updating and latest casks, mise, and all mise-managed tools):
make update-all
# or
MISE_GLOBAL_CONFIG_FILE="$PWD/config/mise/config.toml" mise run update-all
Treat files under home/, config/, local/, and macos/ as shared/tracked by default. Keep machine-specific or secret values in local-only files under $HOME:
~/.env.localfor global secret and machine-specific environment variables loaded by mise ([settings].env_file), includingOBSIDIAN_VAULTpointing to the directory that contains.obsidian~/.config/zsh/aliases.private.zsh~/.config/zsh/aliases.local.zsh~/.config/zsh/functions.local.zsh
~/.config/zsh/init.zsh sources the zsh local files only if they exist. Secret environment variables should live in ~/.env.local using export KEY="value" syntax, not in config/zsh/env.local.zsh. This repo ignores *.local.zsh and .env.local, but does not ignore aliases.private.zsh, so keep aliases.private.zsh outside this repo or add a local Git exclude for config/zsh/aliases.private.zsh.
Before committing, verify local-only files are still untracked:
git status --short --untracked-files=all
The zsh pi wrapper reads ~/.dotfiles/pi/startup-models.local.json
(or $DOTFILES/pi/startup-models.local.json). This ignored file replaces the
shared startup model selection through --models:
["openai-codex/gpt-6-astra", "openai-codex/gpt-6.1-sol", "openai-codex/gpt-6-luna"]
Without this file, shared settings apply. Explicit pi --models ... takes
priority. Requires jq. Run source ~/.config/zsh/functions.zsh after setup.
Direct executable calls (command pi, mise exec -- pi, and app launchers)
bypass this shell wrapper. Model shortcut presets are separate.
To disable push notifications on one machine, create ~/.pi/agent/ntfy.json:
{"enabled": false}
Use $PI_CODING_AGENT_DIR/ntfy.json if you set a custom agent directory.
Remove Finder metadata files:
find . -name '.DS_Store' -delete
Verify repository hygiene:
git ls-files | rg 'DS_Store$'
find . -name '.DS_Store'
git status --short