dotfiles

Personal dotfiles for my own development environment.

Core Stack

• Shell: zsh
• Terminal multiplexer: tmux
• Editor: neovim
• Tool/package management: mise
• zsh plugin management: sheldon

The setup scripts are designed around this stack.

mise loads mise/config.toml as the base config and switches environment-specific config automatically:

• Linux: mise/config.linux.toml
• WSL: mise/config.wsl.toml
• macOS: mise/config.macos.toml

On macOS, package bootstrap is handled with Homebrew and brew/Brewfile.

Setup

First-time setup

git clone https://github.com/daisukekobayashi/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
./setup.sh all

Run setup from repository root

./setup.sh help

Main subcommands.

• ./setup.sh all
• ./setup.sh links
• ./setup.sh packages
• ./setup.sh post

Package step filters.

• ./setup.sh packages --only tmux,luarocks
• ./setup.sh packages --skip quarto
• ./setup.sh packages --dry-run
• ./setup.sh all --reload-shell

Optional environment variables.

• SETUP_HOME
• SETUP_TMPDIR
• SETUP_DOTFILES_ROOT
• SETUP_DRY_RUN (0 or 1)
• SETUP_MISE_STRICT (0 or 1, default: 0)

Example.

SETUP_HOME=/tmp/dotfiles-home SETUP_DRY_RUN=1 ./setup.sh all
./setup.sh all --reload-shell

AI Agent Rules

./setup.sh links also installs generated rule files for Codex, Gemini, and Claude.

Third-party skills are tracked in skills-lock.json.

Custom skills live in skills/.

./setup.sh skills restores third-party skills into .agents/skills, symlinks custom skills from skills/, wires ~/.agents/skills and ~/.claude/skills to that generated directory, and removes a stale ~/.gemini/skills link because Gemini already reads ~/.agents/skills.

.agents/ is a generated restore target and is intentionally ignored by git.

Test

Run setup tests with bats.

bats tests

Static checks.

shellcheck setup.sh lib/common.sh setup/*.sh tests/helpers/*.bash tests/*.bats
bash -n setup.sh lib/common.sh setup/*.sh tests/helpers/*.bash