This repository is the entry point for setting up every machine I use. Mise installs the tools, repositories, shell integration, and dotfiles selected by the macos or linux environment. App repositories own their own internal setup and expose bootstrap and check tasks that this project calls.
Install the mise version required by this repository:
MISE_VERSION=v2026.9.9 curl -fsSL https://mise.run | shThen bootstrap a Mac:
~/.local/bin/mise bootstrap \
--from https://github.com/cx18121/dotfiles.git \
--from-dir "$HOME/dotfiles" \
-E macos \
--locked \
--yesUse -E linux for an Ubuntu or other supported Linux development host.
For an existing checkout:
mise -C ~/dotfiles -E macos bootstrap --lockedPreview or inspect the selected environment without changing it:
mise -C ~/dotfiles -E macos bootstrap --dry-run
mise -C ~/dotfiles -E macos bootstrap status
mise -C ~/dotfiles -E macos run check -- macosmise.toml contains repositories, dotfiles, and the final bootstrap task. managed/mise-tools.toml is linked into mise's global configuration so the exact tools are available from every directory. mise.macos.toml and mise.linux.toml contain only platform-specific composition.
- Mise owns versioned development tools on both platforms.
- Mise's native dotfile manager links configuration into the home directory.
- Homebrew owns macOS applications and native libraries through
brew/Brewfile. pi-personalowns Pi extensions and generated platform settings.herdr-personalowns Herdr configuration, personal commands, and pinned plugins.agent-skillsowns shared reusable skills.personal-cloudowns AWS infrastructure and host-specific safety controls.
Credentials, authentication sessions, caches, terminal sessions, run history, and personal data are deliberately excluded.
Portable Pi settings live in pi-personal. A machine can add packages or override preferences without committing machine-specific paths by creating:
~/.config/pi/settings.local.json
See pi-personal/config/settings.local.example.json for the supported shape.
Update repositories and reapply the selected environment with dot bootstrap --update.
managed/mise-tools.toml lists tools as latest, and managed/mise.lock holds the exact versions every machine installs. The dot shell function runs these from any directory:
dot upgrademoves every tool to its newest version, reapplies the environment, and updates Pi extensions.dot pidoes the same for Pi only.dot bootstrapreapplies the environment at the locked versions.dot checkverifies the whole setup.
Commit managed/mise.lock after an upgrade. To hold a tool back, give it an exact version in managed/mise-tools.toml with a comment saying why.
superset and vscode remain historical settings. They are not applied by the bootstrap.