CLI reference
Run each command as unbound-paws <command>.
| Command | What it does |
|---|---|
init [--global | --settings <path>] | Register the hooks in a settings.json. |
uninstall [--global | --settings <path>] | Remove paws's hook entries and the paws skill it installed. Other settings stay. |
skill [--global | --settings <path>] | Install or reinstall the paws skill next to a settings.json. |
add [--project] [--pick group=option] <pack | category/name>... | Install packs or single rules, with the skills they need. |
remove [--project] <pack> | Uninstall a pack, and skills only it needed. |
list [--project] | Installed packs and portal skills, and how often each rule fired. |
search <text> | Search the catalog by name, tag, skill or description. |
explain [--tool T] [--event E] <text> | Dry-run a call: rules in scope, which apply, the decision. explain - reads a hook event from stdin. |
ui [--port N] [--no-open] | The local page: catalog, installed, activity. |
login [--key <key> | --key -] | Connect this machine to the portal. |
sync [--dry-run] | Upload new records and pull portal settings now. |
logout | Forget the portal login and remove its rules. |
validate [root] | Check a checkout's catalog/ and packs/. For catalog contributors. |
pin [root] | Fetch upstream skills and write their content hashes. For catalog maintainers. |
index [--portal] [-o file] | The catalog as JSON, for the website and the local UI. |
gate | The hook itself. Claude Code runs it, you don't. |
version | Print the version. |
add and search also take --catalog <dir> to read a catalog checkout instead of the one built into the binary.