Appearance
Tool manifest
This manifest is hand-maintained. It records ownership policy, not every installed binary on every host.
mise
Mise owns versioned developer tools and portable CLIs. Project-local versions still win when a project declares them.
Examples:
- Node, pnpm, Python, uv, Ruff, Rust, and npm-managed CLIs.
- Codex and validation tools such as
just,shfmt,shellcheck,taplo,actionlint,typos,markdownlint-cli2,cspell, andgitleaks. - Workstation CLIs such as
rg,fd,bat,delta,lazygit,yazi,chezmoi,starship,atuin,direnv,zoxide,fzf,carapace, andhurlfor repeatable HTTP/API request files.
OS package managers
Use apt on WSL and pacman on CachyOS for platform packages, system libraries, desktop integrations, and tools that are better owned by the OS.
Examples:
- WSL prerequisites such as GitHub CLI apt setup and distro packages.
- CachyOS desktop and editor prerequisites.
- Linux system packages such as
btopwhere the distro is the better owner.
Windows managers
Native Windows uses winget and Scoop for platform bootstrap, Windows-native apps, and GUI tools. Git for Windows is platform infrastructure.
Examples:
- PowerShell, mise bootstrap, Scoop buckets and apps, GUI editors, fonts, and Windows-only utilities.
Fish plugins
Fish plugins are intentionally small and pinned in the managed fish_plugins file. Starship owns the prompt; Fisher is only the lightweight plugin manager.
Current plugin candidates and managed entries should support the Fish-first interactive shell without adding a large framework.
Editor managers
Editor extension managers own editor-specific packages:
- VS Code extension manifests under
editors/vscode/. - Sublime Text Package Control package list and preferences.
Optional lanes
Optional tools belong in optional manifests or workflow-specific docs until a workflow actually uses them. Do not add tools only because they look useful.