Forked from craftzdog/dotfiles by Takuya Matsuyama, with my own tweaks on top.
Warning: Don’t blindly use these settings unless you know what that entails. Use at your own risk!
- Vesper theme everywhere: Ghostty (
Vesper, background blur kept), Neovim (vesper.nvim, transparent), and herdr (vesper). The custom Neovim tabline uses the Vesper palette instead of Solarized Osaka. - oh-my-zsh style shortcuts in fish:
- plugin-git for the oh-my-zsh git aliases (
gst,gco,gcm, …) conf.d/abbr.fish: abbreviations ported from the oh-my-zsh flutter, npm, opencode and vscode plugins (flr,flget,npmrd,opc,vsc, …)
- plugin-git for the oh-my-zsh git aliases (
- Neovim tweaks:
;fuses the snackssmartpicker with frecency (buffers, recent and project files, like VS Code's Cmd+P);;Fis the plain file finder- Up/Down select items in the cmdline completion menu; Option+Left/Right move by word in insert mode
- flutter-tools.nvim with keymaps under
<leader>F(Fddevice,Frrun,Flreload,FRrestart,Fqquit,Fglog,Fooutline,FtDevTools)
- Flutter via fvm:
fvmandcocoapodsin the Brewfile; fish wrapsflutteranddartto run throughfvm, and flutter-tools.nvim uses the project's.fvm/flutter_sdk. - Node via mise:
node = "lts"in the mise config. - Machine-specific settings (paths, SDKs, API keys) live in
~/.config/fish/config-local.fish, which chezmoi ignores, so they never enter this repo.
brew install chezmoi
chezmoi init --apply kxgcayhchezmoi init asks for your name, email and GitHub username to fill in the git config. Applying also installs the Brewfile, global npm packages and fisher plugins.
On macOS, setup also sets Fish as your default login shell. It may ask for your
Mac login password to register Fish in /etc/shells and change the shell. This
step runs once per machine and skips the change if Fish is already the default.
Log out and back in afterward, or run exec fish in your current terminal.
To pull in upstream changes:
git remote add upstream https://github.com/craftzdog/dotfiles.git # once
git fetch upstream && git merge upstream/masterManaged with chezmoi.
- Neovim config
- herdr config (terminal workspace manager for AI agents)
- tmux config
- Ghostty config
- git and lazygit config
- fish config
- PowerShell config
- Homebrew, apt, Scoop and winget package lists
- Neovim >= 0.12 (plugins are managed with the built-in
vim.pack) - Git
- lazygit (optional)
- tree-sitter CLI and a C compiler for
nvim-treesitter - for the snacks.nvim picker:
- a terminal that supports true color and undercurl, such as Ghostty
- vesper.nvim
- Flutter SDK (installed with
fvm) for flutter-tools.nvim (optional)
- Ghostty - Terminal emulator
- herdr - Workspace manager for running AI coding agents side by side, with tmux-style keybindings (prefix
ctrl+t) - tmux - Terminal multiplexer
Installed as Homebrew casks from the Brewfile:
- Meslo Nerd Font for Powerlevel10k (
MesloLGS NF) - Ghostty's font - BlexMono Nerd Font
- Fish shell
- Fisher - Plugin manager
- Tide - Shell theme
- z for fish - Directory jumping
- Eza -
lsreplacement - ghq - Local Git repository organizer
- fzf - Interactive filtering
- plugin-git - oh-my-zsh style git aliases
- Scoop - A command-line installer
- Git for Windows
- Oh My Posh - Prompt theme engine
- Terminal Icons - Folder and file icons
- PSReadLine - Cmdlets for customizing the editing environment, used for autocompletion
- z - Directory jumper
- PSFzf - Fuzzy finder
Takuya's video tutorials explain the original setup:
- My Neovim setup
- My dev workflow using tmux and vim
- A productive command-line Git workflow for indie app developers
- My Fish shell workflow for coding
- How to set up PowerShell prompt with Oh My Posh on Windows 11
Original dotfiles by Takuya Matsuyama (craftzdog):
The Zsh backup includes Powerlevel10k settings. Install Oh My Zsh and the
Powerlevel10k theme separately, plus the plugins listed in .zshrc:
zsh-autosuggestions, zsh-syntax-highlighting, and zsh-interactive-cd.
Built-in plugins come with Oh My Zsh. NVM, jenv, Android SDK, and FVM need their
usual setup before their shell integration is useful.
Before restoring .zshrc, move credentials, custom volume paths, compiler
flags, Windows cross-compilation variables, AI command wrappers, and other
machine overrides from your current shell file into unmanaged ~/.zshrc.local.
The managed shell sources this file first, before the instant prompt and plugin
initialization. Keep local secrets out of Git. PUB_CACHE and EXT_DRIVE belong
there if used; portable home paths use $HOME in the backup. Review chezmoi diff
before applying, and keep a private copy of your old shell settings.
The Brewfile preserves existing entries and adds installed tools and fonts. Explicit additions exclude mingw-w64, xwin, qt, llvm, omp, xmake, deskflow, dotnet-sdk, and mac-sai. Homebrew can still install excluded tools as dependencies.
~/.local/bin/devault-sync exports ai-memory session notes and rebuilds vault
indexes. The LaunchAgent runs every five minutes and at login. The installation
hook reloads the agent when its script or plist changes. Restoring these files
with chezmoi will activate that agent; inspect the proposed changes first.
Python 3 and an existing Obsidian vault are required. No vault content is backed
up here.
Keep the vault location in unmanaged ~/.config/devault/config.json using the
vault field; optionally set ai_memory there for a custom ai-memory data root.
Alternatively the script recognizes DEVAULT_VAULT and AI_MEMORY_DATA_DIR, or
finds a vault named Devault in Obsidian's local settings. launchd does not inherit
interactive shell settings, so prefer the JSON configuration for the agent.
Use devault-sync --where to inspect the chosen vault and --dry-run to preview
writes. Logs and state live in ~/.local/state/devault-sync/.
Install pre-commit and Gitleaks separately, then run pre-commit install in
this repository. The configured hook scans for secrets and literal personal
home or volume paths in changed configuration. CI runs the same path check and
Gitleaks. Local overrides and AI configuration should stay outside the backup.
