Commands & flags

Reference for the shipped @elsai/pm-skills CLI (0.1.x). All server calls are read-only GETs.

Global flags

Flag	Effect
-v, --version	Print CLI version
-h, --help	Help
--json	Machine-readable JSON
--quiet	Suppress progress
--profile <name>	User-config profile
--server <url>	API base URL
--api-key <key>	API key override
--project <id>	Project id override
--env <name>	Optional environment label (echoed; not a skill release gate)
--insecure	Allow http:// (local only)

Commands

Command	Purpose
login	Store credential after whoami validation
logout	Remove stored profile credential
whoami	Verify key and print identity
init [--force] [--agent] [--scope]	Write .pm-skills.json
list	Effective skill set + sync hints
search <query> [--marketplace]	Search resolvable set / marketplace
preview <name> [--version] [--diff]	Render skill from server
pull [--agent] [--scope] [--frozen] [--dry-run] [--force]	Materialize + lockfile
status	Drift report (CI exit codes)
update [name] [--all] [--yes] [--to <sha>]	Advance / roll back pins

Config files

Path	Role
~/.pm-skills/config.json	Credentials per profile (0600)
.pm-skills.json	Repo project binding (commit)
pm-skills.lock.json	Pinned SHAs (commit)

Environment variables

PM_SKILLS_API_KEY · PM_SKILLS_SERVER · PM_SKILLS_PROJECT · PM_SKILLS_ENV · PM_SKILLS_PROFILE