Menu · CLI reference

CLI reference

Run each command as unbound-paws <command>.

CommandWhat 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.
logoutForget 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.
gateThe hook itself. Claude Code runs it, you don't.
versionPrint the version.

add and search also take --catalog <dir> to read a catalog checkout instead of the one built into the binary.