CLI Documentation

Install and use the pollyhub CLI to manage Polly Skills.

Install the CLI

Requires Node.js 18+

Download CLI (.tgz)

Or install directly from this server:

$ npm install -g http://your-pollyhub-host/api/download/cli

On a VM or container with access to this server, run the command above to install in one step.

Authentication

Set your API key via environment variable or pass it inline. API keys are issued by admins.

$ export POLLYHUB_API_KEY=phk_your_key_here

Or pass per-command with --key phk_your_key_here

Commands

pollyhub install

Download and install a skill

$ pollyhub install <skill-name>

Install latest version to ~/.polly/skills/

$ pollyhub install <skill-name>@1.2.0

Install specific version

$ pollyhub install <skill-name> --project

Install to .polly/skills/ (project-local)

pollyhub publish

Publish a skill from the current directory

$ pollyhub publish

Reads SKILL.md from current directory, prompts for version + changelog

$ pollyhub publish --version 1.0.0 --changelog 'Initial release'

Non-interactive mode

pollyhub search

Search the registry

$ pollyhub search <query>

Full-text search skills

pollyhub info

Show skill details and version history

$ pollyhub info <skill-name>

Show all versions and scan status

pollyhub list

List locally installed skills

$ pollyhub list

Shows skills in ~/.polly/skills/ and .polly/skills/

Publishing via API

POST to /api/skills with your API key.

$ curl -X POST https://pollyhub.example.com/api/skills \ -H "x-api-key: phk_your_key" \ -H "Content-Type: application/json" \ -d '{ "slug": "my-skill", "name": "My Skill", "description": "Does something useful.", "tags": ["productivity"], "version": "1.0.0", "changelog": "Initial release", "files": { "SKILL.md": "---\nname: my-skill\ndescription: ...\n---\n# My Skill\n..." } }'