aihubx

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

Install

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

# Once published to npm
# npm i -g aihubx

Auth (publish)

aihubx login
# or
aihubx auth login

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

Notes:

• Browser login opens https://clawhub.ai/cli/auth and completes via a loopback callback.
• Default config path:
  • macOS: ~/Library/Application Support/aihubx/config.json
  • Linux/XDG: $XDG_CONFIG_HOME/aihubx/config.json or ~/.config/aihubx/config.json
  • Windows: %APPDATA%\\aihubx\\config.json
• Legacy fallback: if aihubx/config.json does not exist yet but clawdhub/config.json does, the CLI reuses the legacy path.
• Override via CLAWHUB_CONFIG_PATH (legacy CLAWDHUB_CONFIG_PATH).

Examples

aihubx search "postgres backups"
aihubx install my-skill-pack
aihubx update --all
aihubx update --all --no-input --force
aihubx skill publish ./my-skill-pack --slug my-skill-pack --name "My Skill Pack" --version 1.2.0 --changelog "Fixes + docs"
aihubx skill publish ./org-skill --owner openclaw --version 1.2.0 --changelog "Org publish"
aihubx package explore --family skill
aihubx package explore --family code-plugin
aihubx package inspect @openclaw/example-plugin
aihubx package download @openclaw/example-plugin --tag latest
aihubx package verify ./example-plugin-1.0.0.tgz --package @openclaw/example-plugin --version 1.0.0
aihubx package publish openclaw/example-plugin
aihubx package publish openclaw/[email protected]
aihubx package publish https://github.com/openclaw/example-plugin --dry-run
aihubx package publish ./example-plugin-1.0.0.tgz --dry-run
aihubx package publish ./example-plugin

Publish code plugins

For ClawPack publish, create the npm-pack tarball yourself and upload that exact .tgz:

npm pack
aihubx package publish ./my-plugin-1.0.0.tgz --family code-plugin --dry-run
aihubx package publish ./my-plugin-1.0.0.tgz --family code-plugin

For local plugin folders, start with a dry run:

aihubx package publish ./my-plugin --family code-plugin --dry-run
aihubx package publish ./my-plugin --family code-plugin

For code plugins, folder publish builds and uploads a ClawPack artifact from the package folder. Bundle-plugin folders still use the extracted-file publish path.

Use aihubx package download to resolve the published artifact through ClawHub's explicit artifact route. ClawPack downloads are verified against npm integrity/shasum plus ClawHub SHA-256; legacy package versions still download as ZIPs.

code-plugin packages must declare these package.json fields:

• openclaw.compat.pluginApi
• openclaw.build.openclawVersion

Minimal example:

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2"
    }
  }
}

package.json.version does not replace these OpenClaw-specific fields. Add openclaw.compat.minGatewayVersion and openclaw.build.pluginSdkVersion when you want richer compatibility metadata, but they are not required for publish.

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 AIHUBX_TOKEN secret. For monorepos, pass source_path to publish the plugin package folder, for example source_path: extensions/codex.

Maintainers

The aihubx npm package is released separately from the ClawHub app deploy.

• Release workflow: .github/workflows/clawhub-cli-npm-release.yml
• Release model: manual-only, stable tags only (vX.Y.Z), with a preflight run before the real publish
• Publish auth: npm trusted publishing through the npm-release GitHub environment

Development

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

bun run --cwd packages/aihubx test
bun run --cwd packages/aihubx verify:build
bun run --cwd packages/aihubx test:artifact
bun run --cwd packages/aihubx 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.
aihubx sync

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

Defaults

• Site: https://clawhub.ai (override via --site or CLAWHUB_SITE, legacy CLAWDHUB_SITE)
• Registry: discovered from /.well-known/clawhub.json on the site (legacy /.well-known/clawdhub.json; override via --registry or CLAWHUB_REGISTRY)
• Workdir: current directory (falls back to Clawdbot workspace if configured; override via --workdir or AIHUBX_WORKDIR)
• Install dir: ./skills under workdir (override via --dir)