Personal macOS development environment managed with Chezmoi. Keyboard-centric workflow with extensive automation and tool integration.
Start here: published docs at https://kapral18.github.io/dotfiles/ (source: docs/intro/index.md). The README is an orientation page; recipes, command catalogs, and subsystem detail live in docs/.
| Feature | Description |
|---|---|
| 🤖 Agent Memory | /tmp/specs hook memory (,agent-memory) + durable ,ai-kb |
| 🔄 Ralph | Multi-agent orchestrator (planner → executor → reviewers) |
| 🧠 Local inference | llama.cpp router + model sync (,llama-cpp) |
| 🔐 Secure Identity | 1Password SSH agent with work/personal switching |
| 🌳 Git Worktrees | Worktree management with PR integration |
| 💎 Neovim | Custom LSP, AI commits, refactoring tools |
| 🐚 Fish Shell | 40+ custom productivity commands in ~/bin |
| 📦 Brewfile | 280+ formulas and casks (per-category partials) |
| ⚙️ Mise | Version manager with automatic switching |
- 1Password installed and signed in (SSH agent + secrets).
sh -c "$(curl -fsLS get.chezmoi.io/lb)" -- init --apply kapral18Safer first run: preview with chezmoi init kapral18 && chezmoi diff before applying. See Getting Started and New machine bootstrap for the full first-run story (prompts, hooks, and what gets installed).
Chezmoi renders templates from home/ into $HOME. Hooks in home/.chezmoiscripts/ install and reconcile packages when lists change. The .isWork prompt forks identity, secrets, and some package lists between work and personal machines.
For the full layout (naming conventions, hook lifecycle, AI config merging, externals), see Architecture.
| Area | Doc | Source-of-truth (edit here) |
|---|---|---|
| Packages (Homebrew, mise, cargo, go, …) | Packages | home/.chezmoitemplates/brews/, home/readonly_dot_default-* |
Custom ~/bin commands |
Custom commands | home/exact_bin/ |
| Git identity & worktrees | Worktrees | home/exact_bin/executable_,w |
| GitHub picker & tmux | Tmux | home/dot_config/exact_tmux/ |
| Fish shell | Shell: Fish | home/dot_config/fish/ |
| Neovim | Neovim | home/dot_config/exact_nvim/ |
| Agentic OS (SOPs, MCP, Ralph, llama.cpp) | AI & assistants | home/readonly_AGENTS.md, home/exact_dot_agents/ |
| macOS automation | macOS | home/dot_hammerspoon/, home/.osx.core |
| Reference map (where to change X) | Reference map | — |
High-leverage commands most people reach for first: ,w (worktrees), ,doctor (health check), ,update (pull dotfiles + reconcile packages), ,ralph (orchestrator). Discover the rest with ls ~/bin | rg '^,' or the custom-commands doc.
- Tmux sessions auto-restore (
tmux-resurrect/continuum). ,w add …or the GitHub picker (prefix + G) for branch/PR worktrees.- Neovim for editing;
,updateorchezmoi applyto converge package/config drift.
See A day in the life for a fuller walkthrough.
- Docs hub:
docs/intro/index.md - Contributing (repo development):
CONTRIBUTING.md - Agent instructions:
AGENTS.md - Chezmoi data prompts:
home/.chezmoi.toml.tmpl