| name | ai-setup |
| description | Set up or troubleshoot Yassimba's curated agent skills, Pi packages, Herdr, and Herdr plugins through the ai-setup CLI. Use when the user asks to install this collection, configure Herdr, add one of its capabilities, update the setup, or diagnose installation problems. |
Setup Yassimba
Use the ai-setup CLI as the single setup interface. It installs skills itself and delegates to Pi and Herdr for the rest; do not reproduce that installation logic manually.
Start
Check whether the CLI is available (works in any shell):
ai-setup --version
If the command fails or is not found, treat the CLI as not installed: explain that the bootstrap downloads a checksum-verified binary from the Yassimba/ai-setup GitHub releases, then ask before running the platform command.
macOS or Linux:
curl -fsSL https://raw.githubusercontent.com/Yassimba/ai-setup/main/install.sh | sh
Windows:
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/Yassimba/ai-setup/main/install.ps1 | iex"
Workflows
- First-time setup:
ai-setup setup
- Add selected capabilities:
ai-setup add
- Check the installation:
ai-setup doctor
- Update installed tooling and resources:
ai-setup update
Without flags, setup and add open a full-screen wizard that needs a real terminal; when run from an agent, inspect ai-setup add --help and pass the matching --skill, --pi-package, or --herdr-plugin flags instead.
Before any command that installs or updates software, show what will run and ask for confirmation. doctor is read-only and may run without confirmation. Report partial failures exactly as the CLI prints them; do not claim a failed resource was installed.
