Files
zeekay 214621b6ca Serve the hub at api.hanzo.ai/v1/skills
Every route mounts under /v1/skills, the address api.hanzo.ai routes to
this API; auth, personas, users, tokens, upload, integrations, search and
whoami are sub-resources and RESERVED keeps them from being slugs. The
web, the OG renderers, the CLI's default registry, /.well-known/bothub.json
and openapi.json name api.hanzo.ai. Sign-in calls back to
api.hanzo.ai/v1/skills/auth/callback and hands the token over in the
fragment.

The store starts again. docker-entrypoint.sh read Base's port from
BASE_PORT, which Kubernetes sets to tcp://<ip>:<port> in a namespace
holding a Service named base; Base now listens on 127.0.0.1:8090, fixed.
The collections migration is rewritten for the Base the Dockerfile pins
(1.5.91): flat field options, declared created/updated, and the users
collection every Base already has, extended rather than created twice.

Reads are anonymous against public rules, since Base takes IAM
credentials only and no longer serves password sign-in; writes answer
503 saying so. The catalogue migration, generated by scripts/catalog.mjs,
publishes the 83 skills in hanzoai/bot@8be8f1dc7b. /health reports the
store, so the probes restart a pod whose Base is gone.

cache.ts decides caching once: an anonymous 2xx GET is public for a
minute (five at the edge) with a weak ETag and 304s; a credential, a
write or an error is private, no-store. Filter values go through lit().
Embeddings go through api.hanzo.ai and are skipped without a key.

k8s/ was a second declaration of the deployment; universe is the one.
2026-09-30 01:10:48 -07:00
..

bothub

Bot Hub CLI — install, update, search, and publish agent skills as folders.

Install

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

# Once published to npm
# npm i -g bothub

Auth (publish)

bothub login
# or
bothub auth login

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

Notes:

  • Browser login opens https://hub.hanzo.bot/cli/auth and completes via a loopback callback.
  • Token stored in ~/Library/Application Support/bothub/config.json on macOS (override via BOTHUB_CONFIG_PATH, legacy CLAWDHUB_CONFIG_PATH).

Examples

bothub search "postgres backups"
bothub install my-skill-pack
bothub update --all
bothub update --all --no-input --force
bothub publish ./my-skill-pack --slug my-skill-pack --name "My Skill Pack" --version 1.2.0 --changelog "Fixes + docs"

Sync (upload local skills)

# Start anywhere; scans workdir first, then legacy Clawdis/Clawd/Hanzo Bot/Moltbot locations.
bothub sync

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

Defaults

  • Site: https://hub.hanzo.bot (override via --site or BOTHUB_SITE, legacy CLAWDHUB_SITE)
  • Registry: discovered from /.well-known/bothub.json on the site (legacy /.well-known/bothub.json; override via --registry or BOTHUB_REGISTRY)
  • Workdir: current directory (falls back to Clawdbot workspace if configured; override via --workdir or BOTHUB_WORKDIR)
  • Install dir: ./skills under workdir (override via --dir)