agentx-hub-cli
v0.2.0
Published
Operator CLI for the AgentX hub: sync the registry snapshot into the hub database, moderate verified-run reviews, mirror to the public hub. Registry curation lives in awescholar (pip).
Downloads
257
Maintainers
Readme
v0.2.0 — new mission. The v0.1.x registry-curation commands moved into awescholar (Python):
awescholar updater add | enrich | backfill --agentxandawescholar verify --agentx. This CLI is now the hub operations supplement — the commands that need the hub website or its deployments, which a generic curation toolkit cannot own.
Two tools, one boundary:
| Concern | Lives in | Why |
|---|---|---|
| Registry curation (data/agents-snapshot.json) | awescholar (pip) | Generic: works on any AgentX checkout, shared with the literature pipeline |
| Hub operations (database, reviews, public mirror) | this CLI (npm) | Coupled to the hub website's scripts and workflows — it wraps them, never reimplements them |
Install
npm install -g agentx-hub-cliOr run it without installing:
npx agentx-hub-cli --helpFrom source:
git clone https://github.com/Webioinfo01/agentx-hub-cli
cd agentx-hub-cli && pnpm install && pnpm build
node dist/cli.js --help # or: npm link → agentxCommands
agentx sync [--remote] [--dir <website>] [--repo <repo>] [--ref <ref>]
agentx moderate [--dir <website>] [--approve <id> | --reject <id>]
agentx mirror [--repo <repo>] [--ref <ref>]sync— landdata/agents-snapshot.jsonin the hub database. Local mode (default) runs the website checkout's owndb:apply-snapshot(Prisma-coupled reconcile, shared with the server's boot apply — exactly one implementation).--remotedispatches the hub repo'ssync-dbworkflow instead: same code, run with the repository's production secrets, no local checkout needed.moderate— operate the pending verified-run review queue. Bareagentx moderatelists it;--approve/--reject <id>decides. Pure passthrough to the website'sreviews:moderatescript.mirror— dispatch the hub repo'ssync-publicworkflow: the allowlisted bridge that mirrors user-facing content to the public agentx-hub repo.
Config
No config file. Options come from flags and the environment:
| Variable | Used by | What it does |
|---|---|---|
| AGENTX_WEBSITE_DIR | sync, moderate | Default hub website checkout for local commands (no silent cwd default) |
| AGENTX_HUB_REPO | sync --remote, mirror | Default hub repo (default: Webioinfo01/agentx-hub-dev) |
| GITHUB_TOKEN (or GH_TOKEN) | sync --remote, mirror | Dispatch authentication |
Development
pnpm install
pnpm test # vitest, one file per module
pnpm check # tsc --noEmit
pnpm build # tsup → dist/cli.jsContributing and the release flow live in docs/CONTRIBUTING.md.
