Managed with mise ([dotfiles] section + mise dotfiles).
- mise
- WSL2 or macOS (Linux is treated as WSL)
# Install mise
curl https://mise.run | sh
# Clone this repository (ghq root layout)
git clone https://github.com/kenchan/dotfiles.git ~/src/github.com/kenchan/dotfiles
cd ~/src/github.com/kenchan/dotfiles
mise trust
mise dotfiles apply
mise installOn macOS, install Homebrew first and install mise and
fish with it (brew install mise fish).
| Repository | Target | Mode |
|---|---|---|
config/ |
~/.config/ |
symlink-each |
nvim/ |
~/.config/nvim |
symlink (whole directory) |
claude/ |
~/.claude/ |
symlink-each (except settings.json) |
claude/settings.json |
~/.claude/settings.json |
merge (only the keys it contains) |
bin/ |
~/.local/bin/ |
symlink-each |
apm/ |
~/.apm/ |
symlink-each |
With symlink-each, directories are created as real directories and each
managed file becomes a symlink into this repository. Files created by
applications alongside them are left alone and never enter the repository.
OS-specific files live in os/wsl/ and os/macos/ and are deployed by
mise.linux.toml / mise.macos.toml, which mise loads for the current OS
because auto_env = true is set in .miserc.toml (and globally in
~/.config/mise/miserc.toml).
~/.claude/settings.json stays a regular file on each machine because Claude
Code and herdr (herdr integration install claude adds a SessionStart hook
with an absolute path) also write it. mise dotfiles apply merges in only the
keys in claude/settings.json; other keys are left alone. Settings changed
through Claude Code stay local until you copy them into claude/settings.json.
Removing a key from claude/settings.json does not remove it from machines.
Migrating a machine where ~/.claude/settings.json is still a symlink into this
repository: right after git pull, run mise dotfiles apply (it replaces the
symlink with a copy), then herdr integration install claude to add the
SessionStart hook back.
Deployed files are symlinks into this repository, so just edit them in place (either path is the same file) and commit here.
# Check deployment state
mise dotfiles status
# Start managing a new file
mise dotfiles add ~/.config/newfile
# Create links for files newly added to the repository
mise dotfiles apply- Managed with thoughtbot/rcm, migrated to chezmoi on 2026-01-05 preserving full git history.
- Migrated from chezmoi to mise
[dotfiles]on 2026-07-14.