pilothub

PilotHub CLI — install, update, search, and publish agent skills as folders.

Install

# From this repo (shortcut script at repo root)
bun pilothub --help

# Once published to npm
# npm i -g pilothub

Auth (publish)

pilothub login
# or
pilothub auth login

# Headless / token paste
# or (token paste / headless)
pilothub login --token clh_...

Notes:

• Browser login opens https://pilothub.ai/cli/auth and completes via a loopback callback.
• Token stored in ~/Library/Application Support/pilothub/config.json on macOS (override via PILOTHUB_CONFIG_PATH, legacy PILOTHUB_CONFIG_PATH).

Examples

pilothub search "postgres backups"
pilothub install my-skill-pack
pilothub update --all
pilothub update --all --no-input --force
pilothub publish ./my-skill-pack --slug my-skill-pack --name "My Skill Pack" --version 1.2.0 --changelog "Fixes + docs"

Sync (upload local skills)

# Start anywhere; scans workdir first, then legacy Pilotis/Pilot/PilotBot/Pilotbot locations.
pilothub sync

# Explicit roots + non-interactive dry-run
pilothub sync --root ../pilotis/skills --all --dry-run

Defaults

• Site: https://pilothub.ai (override via --site or PILOTHUB_SITE, legacy PILOTHUB_SITE)
• Registry: discovered from /.well-known/pilothub.json on the site (legacy /.well-known/pilothub.json; override via --registry or PILOTHUB_REGISTRY)
• Workdir: current directory (falls back to Pilotbot workspace if configured; override via --workdir or PILOTHUB_WORKDIR)
• Install dir: ./skills under workdir (override via --dir)