zch

ZCH CLI — install, update, search, and publish agent skills plus OpenClaw packages.

This fork uses a single command entry: zch.

Install

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

# Once published to npm
# npm i -g zonyee-zch

Auth (publish)

zch login
# or
zch auth login

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

Notes:

• Browser login opens https://clawhub.ai/cli/auth and completes via a loopback callback.
• Token stored in ~/Library/Application Support/zch/config.json on macOS (override via ZCH_CONFIG_PATH, fallback CLAWHUB_CONFIG_PATH / CLAWDHUB_CONFIG_PATH).

Examples

zch search "postgres backups"
zch install my-skill-pack
zch update --all
zch update --all --no-input --force
zch skill publish ./my-skill-pack --slug my-skill-pack --name "My Skill Pack" --version 1.2.0 --changelog "Fixes + docs"
zch package explore --family skill
zch package explore --family code-plugin
zch package inspect @openclaw/example-plugin
zch package publish openclaw/example-plugin
zch package publish openclaw/[email protected]
zch package publish https://github.com/openclaw/example-plugin --dry-run
zch package publish ./example-plugin
zch config set registry http://192.168.0.83:8080
zch config get registry

GitHub Actions

This repo also provides an official reusable workflow for plugin repos:

• /.github/workflows/package-publish.yml

Use dry_run: true on pull requests and reserve real publishes for trusted events such as workflow_dispatch or tag pushes with a ZCH_TOKEN secret.

Development

The supported verification flow for this package is package-local:

bun run --cwd packages/clawdhub test
bun run --cwd packages/clawdhub verify:build
bun run --cwd packages/clawdhub test:artifact
bun run --cwd packages/clawdhub verify

test runs source tests only. test:artifact builds dist/ and runs a small smoke suite against the built CLI entrypoint.

Sync (upload local skills)

# Start anywhere; scans workdir first, then legacy Clawdis/Clawd/OpenClaw/Moltbot locations.
zch sync

# Explicit roots + non-interactive dry-run
zch sync --root ../clawdis/skills --all --dry-run

Defaults

• Site: https://clawhub.ai (override via --site or ZCH_SITE; fallback CLAWHUB_SITE, legacy CLAWDHUB_SITE)
• Registry: discovered from /.well-known/clawhub.json on the site (legacy /.well-known/clawdhub.json; override via --registry or ZCH_REGISTRY)
• Persisted registry: zch config set registry <url>
• Workdir: current directory (falls back to Clawdbot/Trae workspace if configured; override via --workdir or ZCH_WORKDIR)
• Install dir: ./skills under workdir (override via --dir)