Install the ClaudeHub CLI globally using your preferred package manager. Node.js 18 or higher is required.

After installation, verify by running ch --version.

Get up and running in under a minute. The CLI uses a git-inspired sync model: initialize your project once, then pull and push skills, workflows, and sub-agents as you work.

npm install -g @claudehubcc/cli

ch login

ch init

ch pull

ch push

The CLI uses API keys to authenticate with ClaudeHub. Keys are stored globally in ~/.claudehub/config.json and sent as a Bearer token on every request.

ch login

ch logout
ch logout -y

ch whoami

Initialize a ClaudeHub project in the current directory. Run this once per repository. It creates a .claudehub/config.json file that tracks which workspace and categories to sync.

ch init
ch init --force

Workspaces group your skills and workflows. The workspace selection is project-scoped and stored in .claudehub/config.json. Use the alias ws for brevity.

ch workspace <subcommand>
ch ws <subcommand>          # alias

ch workspace list
ch ws list

ch workspace use my-workspace
ch ws use 6839a1f2c4e8b3d2a1f0e9c8

ch workspace current

Skills and workflows live in .claude/skills/ in your project, while sub-agents are single .md files under .claude/agents/. A skill is a folder containing SKILL.md. A workflow is detected by the presence of a workflow-graph.yaml file alongside SKILL.md. Pull and push operate on all three types together.

ch pull
ch pull code-review
ch pull triage-bot -f

ch push
ch push code-review
ch push triage-bot -f

Inspect the sync state of your local workspace before committing a pull or push.

ch status

ch diff code-review
ch diff triage-bot

The CLI uses two config files: a global file for credentials and a project-scoped file for workspace and sync settings.

Global config

Located at ~/.claudehub/config.json on all platforms. Stores credentials only.

{
  "apiKey": "sk-ch-...",
  "user": {
    "id": "...",
    "email": "you@company.com",
    "name": "Your Name"
  }
}

Project config

Located at .claudehub/config.json in your project root. Created by ch init. Commit this file to git.

{
  "workspace": {
    "id": "6839a1f2c4e8b3d2a1f0e9c8",
    "name": "my-workspace"
  },
  "categories": ["code-tools", "docs"],
  "ignore": ["draft-*"]
}

Lockfile

Located at .claudehub/lock.json in your project root. Tracks the last synced state of each extension. Commit this file to git (like package-lock.json). Keys are namespaced by type (skill:, workflow:, agent:) so the same name can be used across types without collision.

{
  "skill:code-review": {
    "id": "abc123",
    "version": 3,
    "type": "skill",
    "hash": "sha256-..."
  },
  "workflow:customer-onboard": {
    "id": "def456",
    "version": 5,
    "type": "workflow",
    "hash": "sha256-..."
  },
  "agent:triage-bot": {
    "id": "ghi789",
    "version": 1,
    "type": "agent",
    "hash": "sha256-..."
  }
}

Global flags

Available on every command.

ch --version
ch --help
ch pull --help
ch push --help