Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

cli-butler

/cli-butler

Zarządza narzędziami CLI przez agenta: spisuje zainstalowane, instaluje, aktualizuje, odinstalowuje i śledzi ich pochodzenie.

Repozytorium
cli-butler ↗
Licencja
MIT
Ostatnia zmiana repozytorium
09.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
90
Skrypty
21
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

what CLI tools are installed
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

  1. Capabilities
  2. Presenting results to humans
  3. Safety rules (non-negotiable)
  4. Design docs
Sekcje z nagłówków SKILL.md, w oryginale · 41 linii, 366 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.