Personal macOS dotfiles managed with Chezmoi: Fish, tmux, Neovim, CLI assistants, and package installation.
Read the documentation for setup, command references, and configuration recipes (source: docs/).
| Feature | Description |
|---|---|
| Agent memory | ,ai-kb knowledge base and ,handoff session notes |
| Local inference | llama.cpp router and model sync (,llama-cpp) |
| Git identity | 1Password SSH agent and SSH commit signing |
| Git worktrees | Worktree management with PR integration |
| Neovim | LSP, commit-message assistance, and refactoring tools |
| Fish | Comma-prefixed commands in ~/bin |
| Packages | Homebrew lists by category and mise-managed runtimes |
Use macOS with 1Password installed and signed in for SSH keys and secrets. Applying this setup installs packages, changes shell and macOS settings, and can remove Homebrew packages absent from its Brewfile. Review Getting Started and New machine bootstrap before applying it to an existing machine.
sh -c "$(curl -fsLS get.chezmoi.io/lb)" -- init --apply kapral18If Chezmoi is already installed, preview with chezmoi init kapral18 && chezmoi diff before running chezmoi apply.
Chezmoi renders templates from home/ into $HOME. Hooks in home/.chezmoiscripts/ install and reconcile packages when lists change.
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/, home/exact_lib/ |
| 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/ |
| macOS automation | macOS | home/dot_hammerspoon/, home/.osx.core |
| Reference map (where to change X) | Reference map | — |
- Tmux sessions auto-restore (
tmux-resurrect/continuum). ,w add …or the GitHub picker (prefix + G) for branch/PR worktrees.- Neovim for editing;
,updateto update tools orchezmoi applyto apply the declared configuration and package lists.
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 - License: MIT