Genie Hub

Use the Genie Hub CLI

Install the public npm package, then use your own Genie Hub identity credential for the target environment.…

Install the public npm package, then use your own Genie Hub identity credential for the target environment.


Install from npm


Use Node.js 24 and install the compiled public package globally.


shell
npm install --global @yqnus/genie-hub-cli
genie-hub --help


CLI source access is governed in the private yunquna/genie-hub-cli repository. The public npm package contains compiled CLI output only.


Authenticate with a PAT


Desktop with a local browser


Use interactive OIDC authorization when the CLI can open a browser on the same computer.


shell
genie-hub auth init dev
genie-hub auth check dev

genie-hub auth init pro
genie-hub auth check pro


Remote server device mode


Use explicit Device Flow when the CLI runs on a remote server or terminal-only host.


shell
genie-hub auth init dev --device
genie-hub auth check dev

genie-hub auth init pro --device
genie-hub auth check pro


The remote terminal prints a URL and confirmation code to complete in a browser on another device. The final PAT is stored only in ~/.yqnus/.env on the server. Do not paste PAT values into content, logs, screenshots, or Store packages.


Connect an MCP client


shell
genie-hub mcp stdio --env dev
genie-hub mcp stdio --env pro


The local stdio bridge forwards MCP tool discovery and calls to the selected Genie Hub service. It exits with the client session and does not start a daemon.


Validate, draft, and publish


shell
genie-hub v ./content.md
genie-hub d ./content.md --env dev
genie-hub pub ./skill-dir --env dev --idempotency-key local-skill-release-0001


Keep the same idempotency key when retrying the same failed release issuance attempt.


Install a Skill


shell
genie-hub skills list --env dev
genie-hub skills install skill-id --env dev --to ~/.agents/skills
genie-hub skills install genie-publish --version 1.0.0 --env dev --to ~/.agents/skills


The installer verifies the indexed SHA-256 digest and rejects unsafe ZIP paths before writing the Skill.


Service boundaries


  • /api/v1 is the public versioned REST surface.
  • /mcp is the bearer-only Streamable HTTP MCP surface.
  • /cms-api is the internal Payload REST surface, not an agent integration path.


OIDC handles interactive identity setup. Normal agent calls use the caller's own PAT or OAuth bearer credential.


Troubleshooting


  • Command not found: confirm the npm global bin directory is on PATH.
  • PAT missing: rerun genie-hub auth init dev and then auth check.
  • Skill install requires a directory: include --to ~/.agents/skills.
  • Package unavailable: verify the Store item has a published release before retrying.