joelazar's dotfiles 🚀

Screenshots 🖼️

Wallpaper + Raycast 🖌️

Neovim with my custom config 📝

Eza + fzf 📂🔍

Lazygit 🦥🌱

Zen browser 🧘‍♀️

Zed 📝

---

Overview 🧰

This repo is the source of truth for my macOS setup.

I use chezmoi to manage shell config, editor settings, package installs, macOS defaults, AI tooling, and a pile of small workflow tweaks that are easy to forget until you lose them. The point is simple: I should be able to set up a new machine, run chezmoi apply, and get back to work without rebuilding my environment from memory.

A few quick facts:

• Platform: macOS
• Dotfile manager: chezmoi
• Profiles: private, work, and workstation
• Bootstrap path: bootstrap.sh
• First-run automation: run_once_install_packages.sh.tmpl and run_once_settings.sh.tmpl
• Theme: Catppuccin Mocha across most of the stack
• Fonts: Maple Mono / Maple Mono NF

---

What lives here 📁

Path	What it contains
dot_config/	App and CLI configuration for tools like Fish, Ghostty, Zed, Yazi, Television, Starship, Mise, Lazygit, pgcli, Wireshark, and more
dot_pi/	Pi agent configuration, prompts, themes, modes, and local extensions
dot_agents/	Local skill library in skills/, tracked alongside the global skill lock file dot_agents/dot_skill-lock.json
dot_claude/	Claude Code configuration
dot_claude-work/	Separate Claude Code profile for work
dot_codex/	Codex configuration templates
dot_ipython/	IPython profile config
private_dot_local/bin/	Personal utility scripts
scripts/	Shared helper scripts used by install/setup flows, including pi-packages-update and pi-extensions-sync
Brewfile.private, Brewfile.work, Brewfile.workstation	Package sets by machine type

---

Highlights ✨

Shell and terminal 🐚

My day-to-day shell is Fish, with config in dot_config/private_fish/.

That setup includes:

• vi-style key bindings
• Starship prompt with mise, sudo, and Yazi indicators via dot_config/starship.toml
• Atuin for history
• Zoxide for smarter directory jumping
• Mise for runtime management via dot_config/mise/config.toml
• Television shell integration so Ctrl+T opens context-aware pickers instead of a generic file list

The terminal is Ghostty, configured in dot_config/ghostty/config. It uses Catppuccin Mocha, Maple Mono NF, split navigation shortcuts, a huge scrollback buffer, and a top-mounted quick terminal.

Editors ✍️

I mostly use Zed and Neovim.

Zed is configured in dot_config/zed/ with:

• Vim mode and which-key hints
• custom pane and tab navigation
• tuned git panel and inline blame
• Television-powered file and text search tasks
• Yazi and Lazygit tasks wired into the editor
• AI assistant defaults for day-to-day coding work

Neovim lives in a separate repo: joelazar/nvim-config. This repo bootstraps it during first-run setup.

Search, navigation, and file management 🔎

A lot of this setup is about moving around quickly:

• Yazi for file management via dot_config/yazi/
• fzf, fd, and ripgrep for fast terminal navigation
• Eza for directory listings via dot_config/eza/
• Television with 105 channels in dot_config/television/cable/

Those Television channels cover far more than files. There are pickers for git branches, worktrees, diffs, repositories, Docker and Kubernetes resources, AWS resources, ports, launchd services, recent files, markdown search, and more.

Git and GitHub workflow 🌿

Git tooling is a big part of this repo:

• Lazygit config in private_Library/private_Application Support/lazygit/config.yml
• gh-dash config in dot_config/gh-dash/config.yml
• gh-repo-man config in dot_config/gh-repo-man/config.yml
• delta + diffnav for readable diffs
• custom scripts for repo cleanup, worktree creation, and recursive repo management

The Lazygit setup includes custom PR commands, conventional commit helpers, GitHub shortcuts, Catppuccin Mocha styling, and delta-powered diff views.

macOS workflow 🍎

This repo also handles the machine itself, not just terminal tools.

• AeroSpace tiling window manager config in dot_aerospace.toml
• Karabiner-Elements keyboard remapping in dot_config/private_karabiner/, including a disable_cmd_tab.json profile
• macOS defaults and shell/editor bootstrapping in run_once_settings.sh.tmpl
• launch agents in private_Library/LaunchAgents/
• app defaults, file associations, Dock behavior, keyboard repeat, Touch ID for sudo, and similar setup tasks

AeroSpace is set up with workspace assignments, vim-style focus movement, resize modes, and app launch shortcuts for tools I use constantly.

---

AI and coding-agent setup 🤖

A lot of this repo is devoted to AI-assisted development. That part has grown quite a bit.

Agent clients and configs 🛠️

This repo currently tracks config for:

• Claude Code in dot_claude/
• a separate Claude work profile in dot_claude-work/
• Pi in dot_pi/
• Codex templates in dot_codex/
• Ollama for local models

There is also a small helper script, ai-update, that updates the main CLI agents and Pi extensions.

Pi agent 🥧

Pi is where most of the custom work happens.

The config in dot_pi/agent/ includes:

• Catppuccin Mocha theme in dot_pi/agent/themes/
• local model definitions in dot_pi/agent/models.json
• guardrails for secrets, sensitive files, and permissions in dot_pi/agent/extensions/guardrails.json
• a managed settings modifier in dot_pi/agent/modify_private_settings.json that tracks shared keys while preserving local-only ones

Models cycle forward with ctrl+space via dot_pi/agent/keybindings.json. The enabled set lives in enabledModels in the managed settings.

Local Pi extensions 🧩

There are 12 local Pi extensions in dot_pi/agent/extensions/. The ones I rely on most are:

• lazygit integration
• sandbox and the guardrails.json config for policy and permission control
• answer, context, and split-fork for session and context handling
• commit and pr-create for git and GitHub workflows
• copy-command, cwd-history, and export-md for everyday shortcuts
• project-trust and anthropic-extra for provider and trust setup
• private_rtk.ts, which rewrites bash commands through rtk to save tokens

Local skills 🎯

The skill library under dot_agents/ uses the skills CLI's global lock file, tracked as dot_agents/dot_skill-lock.json and applied to ~/.agents/.skill-lock.json.

Local skills live under dot_agents/skills/ and include exe-dev, github, listen-later, mermaid, presenterm, reddit, session-analyzer, simplify, uv, and web-search, plus symlinked kagi-cli and save-to-spotify. Remote skills are tracked in the lock file and updated with skills update -g.

The skills-invocation script re-applies the local invocation policy after skills update re-clones github-sourced skills.

---

Package management 📦

Package installation is split by machine type:

• Brewfile.private
• Brewfile.work
• Brewfile.workstation

On first apply, run_once_install_packages.sh.tmpl takes care of the rest. That script installs the Homebrew bundle, UV tools, GitHub CLI plugins, Yazi plugins, and Magic from Modular.

Some notable pieces from the current setup:

• Node globals managed by mise through dot_default-npm-packages: Pi, gondolin, ccusage, defuddle, npm-check, obsidian-headless, and skills
• UV tools installed with extra dependencies: ansible-core (with ansible and netaddr) and pgcli (with Catppuccin styling and psycopg[binary])
• GitHub CLI plugins gh-dash and gh-repo-man
• Casks vary by machine type, for example Karabiner-Elements, plus Helium browser and Inkscape on the work profile

---

Setup ⚡

Fresh machine 🆕

If Homebrew and chezmoi are not installed yet, start with:

shCopy
curl -sSL https://raw.githubusercontent.com/joelazar/dotfiles/main/bootstrap.sh | bash

Or clone locally and run:

shCopy
git clone https://github.com/joelazar/dotfiles.git
cd dotfiles
./bootstrap.sh

Existing chezmoi setup 🔧

If you already have Homebrew and chezmoi:

shCopy
brew install chezmoi
chezmoi init https://github.com/joelazar/dotfiles.git
chezmoi apply

First-time prompts 💬

During initialization, chezmoi asks for:

• git email
• git username
• machine type: work, private, or workstation

Those values come from .chezmoi.toml.tmpl.

Important note ⚠️

This repo is the chezmoi source directory, not the live destination.

If you edit files here, you need to run:

shCopy
chezmoi apply

Without that step, your real dotfiles under $HOME will not change.

---

Day-to-day maintenance 🔁

A few commands I use a lot:

shCopy
chezmoi apply            # push source changes into the live home directory
chezmoi diff             # preview what will change

---

Custom scripts 🧑‍💻

Most of the personal helpers live in private_dot_local/bin/.

Script	What it does
agent-md	Creates or fixes AGENTS.md / CLAUDE.md files for coding-agent projects
ai-update	Updates Claude Code, Codex, Pi, and Pi local packages
backup	Encrypted backups with restic and age
chatterbox	Local text-to-speech via the Chatterbox TTS model
cht	Quick cheat-sheet lookup via cht.sh
claude-private	Launches the Claude desktop app with the default profile
claude-work	Launches the Claude desktop app with a separate work data dir
code-snippet.applescript	Raycast script that wraps selected text in a code block
custom-update	Runs broader system and tool updates
discord-summary	Summarizes the last 24h of selected Discord channels via kagi
fonttest	Checks terminal font rendering
formatter	Formats USB drives and SD cards with a gum UI
git-repo-manager	Finds git repos recursively and offers interactive actions
git-reset	Resets repos back to their default branch state
git-worktree-new	Creates sibling worktrees for the current repo
init-windows	Opens my usual app set for a work session
kokoro	Local text-to-speech via the Kokoro ONNX model
listen-later	Turns an article, file, or text into a Kokoro-narrated Spotify episode
obsidian-update	Triggers Obsidian plugin and theme updates across vaults
pi	Runs the Pi agent CLI through the mise-managed Node 24 runtime
pr-create	Creates pull requests with a guided interactive prompt
skills-invocation	Re-applies the skill invocation policy after skills update
switch-main-display	Changes the primary display on multi-monitor setups
transcribe	Offline audio/video transcription via whisper.cpp
transfer	Uploads files through transfer.sh
untilfail	Repeats a command until it fails
update-submodules	Updates git submodules
wtfport	Shows what is listening on a port and can kill it

Shared shell helpers used by the setup scripts live in scripts/utils and scripts/utils_install.

---

Theming 🎨

Catppuccin Mocha is the common thread through most of the environment: Ghostty, Tmux, Fish, Yazi, Television, Lazygit, Bat, Btop, Starship, Atuin, Eza, Delta, Fzf, Gh-Dash, K9s, and Zed all use it in one form or another.

Fonts are centered on Maple Mono and Maple Mono NF, including OpenType alternates like cv02, cv05, cv61, and cv63.

---

Acknowledgements 🙏

Some helper functions and setup patterns were originally adapted from alrra/dotfiles.

Parts of the Pi setup are also adapted from or inspired by work from:

Author	GitHub	Contributions
Mario Zechner	@badlogic	Pi itself, plus extensions and skills adapted from the Pi ecosystem, such as sandbox
Armin Ronacher	@mitsuhiko	Extensions and skills adapted from agent-stuff, including answer, context, and split-fork
Aliou Diallo	@aliou	pi-guardrails and pi-processes packages
Fero	@ferologics	session-analyzer skill from the Pi skills ecosystem

---

License 📄

This repository is available under the MIT license.