docs(docs): update documentation for tool installation and desktop app changes

This commit is contained in:
Prad Nukala committed 2026-10-16 14:08:32 -04:00
1 parent 31e42d412e
commit fd1fd0cc16
16 files changed
+63 -42

No files matched your search

+5 -4
View File
@@ -65,14 +65,15 @@ Pulling a remote change before the refresh window: `chezmoi apply --refresh-exte
| Key | Installed by | When |
| --- | --- | --- |
| `arch.pacman` / `arch.aur` | `10-packages` (pacman / `yay` or `paru`) | every Linux role |
| `arch.pacman` / `arch.aur` | `10-packages` (pacman / `yay` or `paru`; yay bootstrapped if neither exists) | every Linux role |
| `arch.desktop.pacman` / `.aur` | same | roles `desktop`, `laptop` |
| `arch.desktop.omarchy` | pacman, only if `pacman-conf -l` lists `omarchy` | Omarchy machines |
| `darwin.brew` / `.cask` | Homebrew | macOS |
| `shared.cargo` | `40-post`, if `cargo` exists | every OS |
| `shared.gh_extensions` | `20-gh-extensions` | every OS |
| `shared.cargo` | `15-tools`, after installing rustup if `cargo` is missing | every OS |
| `shared.mise` | `15-tools`: `mise use -g` for tools absent from the global config | every OS |
| `shared.gh_extensions` | `20-gh-extensions` (fish script, so fish config is sourced) | every OS |
Find the package with `pacman -Qo "$(command -v <bin>)"`; `pacman -Qm` lists AUR/foreign packages, `pacman -Si <pkg>` shows the repo (`extra` vs `omarchy`). Verify names before committing: `pacman -Si` for repo packages, `https://aur.archlinux.org/rpc/v5/info?arg[]=<pkg>` for AUR, `https://formulae.brew.sh/api/formula/<name>.json` for brew. Hyprland/Waybar/`omarchy-*` come with Omarchy and are not declared. Tools installed through `mise` (`~/.config/mise/config.toml`, local-only) are not covered by the manifest.
Find the package with `pacman -Qo "$(command -v <bin>)"`; `pacman -Qm` lists AUR/foreign packages, `pacman -Si <pkg>` shows the repo (`extra` vs `omarchy`). Verify names before committing: `pacman -Si` for repo packages, `https://aur.archlinux.org/rpc/v5/info?arg[]=<pkg>` for AUR, `https://formulae.brew.sh/api/formula/<name>.json` for brew, `mise registry <tool>` for mise (no registry entry: use a backend spec such as `github:owner/repo`). Hyprland/Waybar/`omarchy-*` come with Omarchy and are not declared. CLIs that mise can install (omp, opencode, …) go in `shared.mise`, not a curl installer; `15-tools` curl-installs only rustup and strata. `shared.mise` mirrors the global `~/.config/mise/config.toml`: a tool added there with `mise use -g` belongs in the list too.
## Verify