Skip to content

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, and gitleaks.
  • Workstation CLIs such as rg, fd, bat, delta, lazygit, yazi, chezmoi, starship, atuin, direnv, zoxide, fzf, carapace, and hurl for 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 btop where 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.