cli-butler
/cli-butler
Zarządza narzędziami CLI przez agenta: spisuje zainstalowane, instaluje, aktualizuje, odinstalowuje i śledzi ich pochodzenie.
- Autor
- kelegele ↗
- Repozytorium
- cli-butler ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 90
- Skrypty
- 21
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 21 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: bin/cap.sh, bin/install.sh, bin/list.sh, bin/manage.sh, bin/refchain.sh, bin/uninstall.sh, lib/channels.sh, lib/common.sh
Co robi i kiedy
Zarządza narzędziami CLI przez agenta: spisuje zainstalowane, instaluje, aktualizuje, odinstalowuje i śledzi ich pochodzenie.
Wyzwalacze z opisu
Oryginalny opis (EN)
Manage local CLI tools through any agent — inventory every installed CLI across package managers (brew, npm, pipx, uv, cargo, gem, apt), install/upgrade/uninstall with provenance routing, trace a CLI's full reference chain (symlinks, PATH lines, launchd, config files, last-used), and enumerate what a CLI can do. Use when the user asks to install, uninstall, upgrade or list CLI tools, asks "what CLI tools are installed", wants to know where a CLI comes from or what references it, or wants to know a command's capabilities. Zero third-party dependencies, macOS/Linux.
Jak działa
- Capabilities
- Presenting results to humans
- Safety rules (non-negotiable)
- Design docs
Podgląd SKILL.md
--- name: cli-butler description: Manage local CLI tools through any agent — inventory every installed CLI across package managers (brew, npm, pipx, uv, cargo, gem, apt), install/upgrade/uninstall with provenance routing, trace a CLI's full reference chain (symlinks, PATH lines, launchd, config files, last-used), and enumerate what a CLI can do. Use when the user asks to install, uninstall, upgrade or list CLI tools, asks "what CLI tools are installed", wants to know where a CLI comes from or what references it, or wants to know a command's capabilities. Zero third-party dependencies, macOS/Linux. --- # cli-butler Agent skill for managing local CLI tools. Status: **v0.1.1 stable** (see `docs/REQUIREMENTS.md`). ## Capabilities | Command | What it does | |---------|--------------| | `bin/list.sh` | Inventory every CLI grouped by channel, each with a one-line description; system-bundled CLIs get their own group marked non-uninstallable. `--by-function` re-groups by purpose (AI agents, mobile dev, containers, runtimes, web, media, VCS, libraries, system) with channel as a per-row attribute | | `bin/manage.sh` | `info <cli>` / `outdated` / `upgrade <cli>` | | `bin/install.sh` | Install via the right channel, record provenance | | `bin/uninstall.sh` | Channel-routed uninstall; manual items go through refchain + dry-run + confirm | | `bin/refchain.sh` | Five-layer reference chain: symlink → channel → PATH lines → launchd → configs; last-used | | `bin/cap.sh` | Enumerate a CLI's subcommands from its help output | ## Presenting results to humans Raw output is grouped by **channel** (that is the management view — it decides upgrade/uninstall routing and safety). When answering a user's "what do I have" question, re-present grouped by **function/purpose** (AI agents, containers, mobile dev, languages, web/network, media, version control, self-written scripts, library dependencies, system-bundled), with the channel shown as a per-item attribute — e.g. `docker (brew)`. Users think in purposes, not in package managers. ## Safety rules (non-negotiable) 1. **Never `rm` a binary owned by a package manager.** Always route through the owning channel (`brew uninstall`, `npm uninstall -g`, …). Direct deletion corrupts the channel's database. 2. **Uninstall is dry-run first.** Show planned actions, require explicit confirmation (`--yes` or interactive). 3. **launchd services are disabled by moving the plist away** (e.g. to `.plist.off`), never by `launchctl bootout` alone — bootout only unregisters the current session; the service returns on next login. 4. **App-embedded symlinks** (e.g. `/usr/local/bin/docker` → inside an .app): move the symlink aside (`.bak`), never delete the app's internals. 5. Single channel probe failures never block the whole inventory; report them, don't guess. 6. **System-bundled CLIs are never uninstalled.** Anything under macOS SIP-protected prefixes (`/usr/bin`, `/bin`, `/sbin`, `/usr/sbin`) is listed but refused on uninstall, with the reason stated. ## Design docs - `docs/REQUIREMENTS.md` — requirements (source of truth) - `docs/provenance.md` — channel model, ownership resolution, journal format - `docs/design.md` — architecture and conventions
Pliki w paczce (90)
- .agent-handoff.json 1 KB
- .gitignore 1 KB
- AGENTS.md 1 KB
- HANDOVER.md 5 KB
- LICENSE 1 KB
- README.md 2 KB
- SKILL.md 3 KB
- bin/cap.sh 2 KB
- bin/install.sh 3 KB
- bin/list.sh 8 KB
- bin/manage.sh 3 KB
- bin/refchain.sh 4 KB
- bin/uninstall.sh 3 KB
- docs/REQUIREMENTS.md 6 KB
- docs/design.md 1 KB
- docs/provenance.md 3 KB
- docs/superpowers/plans/2026-11-09-cli-butler-v0.1.md 13 KB
- lib/channels.sh 10 KB
- lib/common.sh 6 KB
- lib/function.sh 2 KB
- scripts/agent_hook.py 5 KB
- tasks/2026-11-09-impl-publish.md 6 KB
- tests/lib.sh 1 KB
- tests/run.sh 1 KB
- tests/test_cap.sh 1 KB
- tests/test_channels.sh 6 KB
- tests/test_common.sh 3 KB
- tests/test_function.sh 2 KB
- tests/test_install.sh 2 KB
- tests/test_list.sh 5 KB
- tests/test_manage.sh 2 KB
- tests/test_refchain.sh 3 KB
- tests/test_uninstall.sh 3 KB
- tests/fixtures/bin/black 1 KB
- tests/fixtures/bin/brew 1 KB
- tests/fixtures/bin/bundler 1 KB
- tests/fixtures/bin/cargo 1 KB
- tests/fixtures/bin/claude 1 KB
- tests/fixtures/bin/corepack 1 KB
- tests/fixtures/bin/cowsay 1 KB
- tests/fixtures/bin/dpkg-query 1 KB
- tests/fixtures/bin/duckdb 1 KB
- tests/fixtures/bin/fd 1 KB
- tests/fixtures/bin/fd-find 1 KB
- tests/fixtures/bin/gem 1 KB
- tests/fixtures/bin/httpie 1 KB
- tests/fixtures/bin/loose-tool 1 KB
- tests/fixtures/bin/npm 1 KB
- tests/fixtures/bin/orbstack 1 KB
- tests/fixtures/bin/pipx 1 KB
- tests/fixtures/bin/pnpm 1 KB
- tests/fixtures/bin/rake 1 KB
- tests/fixtures/bin/ripgrep 1 KB
- tests/fixtures/bin/tool-plain 1 KB
- tests/fixtures/bin/typescript 1 KB
- tests/fixtures/bin/uv 1 KB
- tests/fixtures/bin/webget 1 KB
- tests/fixtures/bin/whatis 1 KB
- tests/fixtures/cap/garbage-cli 1 KB
- tests/fixtures/cap/good-cli 1 KB
- tests/fixtures/cap/h-only 1 KB
- tests/fixtures/cap/slow-cli 1 KB
- tests/fixtures/data/brew-cask-versions.txt 1 KB
- tests/fixtures/data/brew-cask.txt 1 KB
- tests/fixtures/data/brew-desc.txt 1 KB
- tests/fixtures/data/brew-formula-versions.txt 1 KB
- tests/fixtures/data/brew-formula.txt 1 KB
- tests/fixtures/data/brew-outdated.txt 1 KB
- tests/fixtures/data/brew-versions.txt 1 KB
- tests/fixtures/data/cargo-list.txt 1 KB
- tests/fixtures/data/dpkg-files.txt 1 KB
- tests/fixtures/data/dpkg.txt 1 KB
- tests/fixtures/data/gem-desc.txt 1 KB
- tests/fixtures/data/gem-list.txt 1 KB
- tests/fixtures/data/npm-ls.txt 1 KB
- tests/fixtures/data/npm-outdated.txt 1 KB
- tests/fixtures/data/pipx-empty.txt 1 KB
- tests/fixtures/data/pipx-list.txt 1 KB
- tests/fixtures/data/pnpm-ls.txt 1 KB
- tests/fixtures/data/uv-list.txt 1 KB
- tests/fixtures/data/whatis.txt 1 KB
- tests/fixtures/data/zsh_history 1 KB
- tests/fixtures/home/.gitconfig 1 KB
- tests/fixtures/home/zsh_history 1 KB
- tests/fixtures/home/zshrc 1 KB
- tests/fixtures/home/.ssh/config 1 KB
- tests/fixtures/home/LaunchAgents/ai.fake.tool.plist.off 1 KB
- tests/fixtures/home/LaunchAgents/com.fake.brewsvc.plist 1 KB
- tests/fixtures/prefix/systembin/sh 1 KB
- tests/fixtures/refchain/real/real-tool 1 KB
Wersje
W bazie nie ma innych skilli o nazwie cli-butler.
Migawka bazy z 13.11.2026 · wersja paczki bbf59d7f92c9 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100cli-tools
Instaluje narzędzia CLI takie jak ripgrep, fd, jq, yq i bat, gdy polecenie kończy się błędem „command not found”, oraz audytuje środowiska i aktualizuje narzędzia zbiorczo. - 100uv-tool-management
Instaluje globalne narzędzia CLI w Pythonie i zarządza nimi przez uv jako alternatywę dla pipx, w tym uv tool i uvx. - 100installing-cli-tools
Instaluje, aktualizuje, konfiguruje i weryfikuje narzędzia CLI dla deweloperów: PATH, uzupełnianie poleceń, pierwsze logowanie, klucze API i zmienne środowiskowe, bez ujawniania sekretów. - 100itch-publish
Publikuje i aktualizuje grę na itch.io: tworzy stronę projektu i wgrywa buildy przez butler push do nazwanych kanałów dla Windows, macOS, Linux i HTML5, z wersjonowaniem. - 90nix-tool-policy
Pilnuje, by narzędzia CLI w repozytorium Nix pochodziły wyłącznie z powłoki deweloperskiej lub nix shell. - 100macos-clean-uninstall
Dokładnie odinstalowuje aplikacje, narzędzia CLI i pakiety w macOS po zbadaniu ich śladów oraz sprawdza, jakie pozostałości po usuniętej aplikacji zostały na dysku.