Skip to content
kenchanPublic

About

kenchan's dotfiles.

Resources

Stars

20 stars

Watchers

2 watching

Forks

Latest commit

 

History

1,044 Commits

Folders and files

Repository files navigation

kenchan's dotfiles

Managed with mise ([dotfiles] section + mise dotfiles).

Requirements

  • mise
  • WSL2 or macOS (Linux is treated as WSL)

Install

# 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 install

On macOS, install Homebrew first and install mise and fish with it (brew install mise fish).

Layout

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.

Usage

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

Migration History

  • 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.

License

MIT License

About

kenchan's dotfiles.

Resources

Stars

20 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages