`hcp-cli`

The **hcp CLI is the first pack** — local store, catalog search, and scaffold.

$ hcpx doctor --json

Commands

CommandWhat it doesEffect

hcp.doctorDoctor the local HCP home and bootstrap.hcpx doctorReads

hcp.availabilityReport pack availability (installed/activated/connected/executable).hcpx availabilityReads

hcp.listList installed packs.hcpx listReads

hcp.searchSearch the community pack catalog.hcpx search {{query}}Reads

hcp.catalogShow catalog entries, or one pack_id.hcpx catalog {{pack_id}}Reads

hcp.initScaffold a pack directory from a class or gold template.hcpx init {{id}}Writes

hcp.installInstall a pack directory into $HCP_HOME/packs.hcpx install {{path}}Writes

hcp.uninstallUninstall a pack from the local store.hcpx uninstall {{pack_id}}Writes

hcp.activateActivate installed pack(s) on the harness session.hcpx activate {{pack_id}}Writes

hcp.deactivateDeactivate pack(s) from the harness session.hcpx deactivate {{pack_id}}Writes

hcp.connectConnect Binding for an activated pack.hcpx connect {{pack_id}}Writes

hcp.execExecute a Verb on an activated pack.hcpx exec {{pack_id}} {{verb_key}}Writes

hcp.lintLint a pack directory before install.hcpx lint {{path}}Reads

hcp.generateGenerate native harness surfaces (OpenCode / Cursor / AI-SDK).hcpx generateReads

hcp.adoptAdopt HCP into a host as one Skill + one bash wrap (agent|cursor|opencode|mcp|grok).hcpx adopt {{target}}Writes

hcp.skillPrint the Skill (HARNESS.md) for an installed pack.hcpx skill {{pack_id}}Reads

hcp.sharePrint a community catalog row for a pack directory or GitHub ref.hcpx share {{path}}Reads

hcp.mcpStdio MCP export: one tool named hcp wrapping bash hcp.hcpx mcpReads

The commands come from the pack's own surface.json and policy.json, and every HCP runtime refuses one marked asks first until a person agrees.