@aksellor/ai-hub-runner
v0.1.6
Published
Local companion CLI for AI Hub — connects your laptop for hosted execution.
Maintainers
Readme
@aksellor/ai-hub-runner
Local companion CLI for AI Hub. Connects to the AI Hub backend over WebSocket for hosted execution on your laptop.
Package name: @aksellor/ai-hub-runner
Binary: ai-hub-runner
External developers (hosted AI Hub)
No AI Hub clone required. From your project repo:
export AI_HUB_URL=https://ai-hub-lemon.vercel.app
pnpm dlx @aksellor/ai-hub-runner login <token>
pnpm dlx @aksellor/ai-hub-runner start
cd /path/to/your/project
pnpm dlx @aksellor/ai-hub-runner register <project-id> .Monorepo development (AI Hub repo)
From the repo root:
pnpm install
cd packages/runner && pnpm run buildpnpm exec ai-hub-runner login <token>
pnpm exec ai-hub-runner startOr from packages/runner: pnpm run dev login <token> / pnpm run dev start
Config
- Token is stored in
~/.ai-hub-runner/config.json(or./.ai-hub-runner/config.jsonif that file exists). - Workspaces are stored in
~/.ai-hub-runner/workspaces.json. - Override AI Hub URL:
AI_HUB_URL=https://app.example.com pnpm dlx @aksellor/ai-hub-runner start
Publishing (operators)
Before external users can pnpm dlx the package:
cd packages/runner
npm version patch # bump before republish
npm login
npm publish --access publicCurrent published package: @aksellor/ai-hub-runner (see package.json version).
Verify pack/install locally:
pnpm run verify:runner-package-publishableRunning AI Hub with runner support
Use the custom server so the WebSocket endpoint is available:
pnpm devThis runs node server.js (Next.js + WebSocket on /api/runner/connect). Without it, the runner cannot connect; token generation and status still work via HTTP.
