{"_id":"@alacrity-ai/kbrelay","name":"@alacrity-ai/kbrelay","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@alacrity-ai/kbrelay","version":"0.1.0","description":"Run kbRelay locally with one command — the kanban board where humans and agents relay work. One process serves the API, the web UI, and an embedded SQLite database.","type":"module","license":"Elastic-2.0","private":false,"bin":{"kbrelay":"bin/kbrelay.mjs"},"publishConfig":{"access":"public"},"engines":{"node":">=22"},"scripts":{"build":"node scripts/build.mjs","prepublishOnly":"npm run build","typecheck":"node --check bin/kbrelay.mjs && node --check scripts/build.mjs","test":"node --test test/*.test.mjs"},"keywords":["kbrelay","kanban","agents","self-host","mcp","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/alacrity-ai/kbRelay.git","directory":"packages/selfhost"},"homepage":"https://github.com/alacrity-ai/kbRelay#readme","dependencies":{"@libsql/client":"0.17.4"},"gitHead":"d0afee31f4833fa70b4296bf7b93ece37639bec3","_id":"@alacrity-ai/kbrelay@0.1.0","bugs":{"url":"https://github.com/alacrity-ai/kbRelay/issues"},"_nodeVersion":"24.7.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-nGgKHuWDPeSKd3e3X6wwUC53MO2bO8Yc6HpisXIgHcGAEG8wQ5EPbW1XuFJUy/23wrdOZ585LquNforSPyMrQQ==","shasum":"ea0ed94cea8b5fec8252833395ec30788b82f2c1","tarball":"https://registry.npmjs.org/@alacrity-ai/kbrelay/-/kbrelay-0.1.0.tgz","fileCount":40,"unpackedSize":1628958,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHOXMnAfWX4snjHRxteL8GDFID+eL5JTy0MjcwONuDiaAiEAjOigV2C6Og1kf97M7sB2fPwILCvj5k3QCjI0iaL02Wc="}]},"_npmUser":{"name":"leifkt","email":"leif@lalalimited.com"},"directories":{},"maintainers":[{"name":"leifkt","email":"leif@lalalimited.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kbrelay_0.1.0_1783486265100_0.345000872935431"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-08T04:51:04.929Z","0.1.0":"2026-07-08T04:51:05.269Z","modified":"2026-07-08T04:51:05.610Z"},"maintainers":[{"name":"leifkt","email":"leif@lalalimited.com"}],"description":"Run kbRelay locally with one command — the kanban board where humans and agents relay work. One process serves the API, the web UI, and an embedded SQLite database.","homepage":"https://github.com/alacrity-ai/kbRelay#readme","keywords":["kbrelay","kanban","agents","self-host","mcp","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/alacrity-ai/kbRelay.git","directory":"packages/selfhost"},"bugs":{"url":"https://github.com/alacrity-ai/kbRelay/issues"},"license":"Elastic-2.0","readme":"# @alacrity-ai/kbrelay\n\nRun **[kbRelay](https://github.com/alacrity-ai/kbRelay)** — the kanban board where humans and agents relay work to each other — locally with **one command**. No repo clone, no Docker, no config files. One Node process serves the API, the web UI, and an embedded SQLite database.\n\n```bash\nnpx @alacrity-ai/kbrelay\n```\n\nOpen the printed URL (default `http://localhost:8080`), **Sign up** — that creates your workspace and makes you its admin. No email setup required.\n\nThen give an agent kanban powers (two steps, shown in the boot banner too):\n\n1. In the app: **Team & access → Agents** → create an agent → copy its API key.\n2. Attach the published MCP server (Claude Code shown; Cursor/Windsurf/Cline work the same way):\n\n```bash\nclaude mcp add kbrelay --scope user \\\n  --env KBRELAY_BASE_URL=http://localhost:8080 \\\n  --env KBRELAY_API_KEY=<your key> \\\n  -- npx -y @alacrity-ai/kbrelaymcp\n```\n\n## Commands & flags\n\n```bash\nkbrelay [start]                # run the server (default)\n  --port <n>                   #   default 8080; if busy, walks to the next free port\n  --data-dir <dir>             #   default ~/.kbrelay (or env KBRELAY_DATA_DIR)\n\nkbrelay mint-tenant \\          # headless bootstrap — no browser needed\n  --tenant \"Acme\" --name \"Ada\" --email ada@acme.com \\\n  [--password <pw>] [--label admin-key]\n                               #   prints an admin API token ONCE\n\nkbrelay --version | --help\n```\n\n## Where your data lives\n\nEverything persists in `~/.kbrelay/` (override with `--data-dir` / `KBRELAY_DATA_DIR`), deliberately **outside** the npx cache so it survives package upgrades:\n\n| Path | What |\n|---|---|\n| `kbrelay.db` | the SQLite database |\n| `attachments/` | card attachments |\n| `jwt-secret` | auto-generated session-signing secret (mode 0600 — never printed; deleting it signs everyone out) |\n\n## Upgrading\n\n```bash\nnpx @alacrity-ai/kbrelay@latest\n```\n\nDatabase migrations are additive-only and apply automatically on boot, so pointing a newer version at an existing data dir is safe.\n\n## Requirements & notes\n\n- **Node ≥ 22** (the launcher checks and says so). Linux, macOS, and WSL are supported; on native Windows, use WSL.\n- The only native dependency (`@libsql/client`) installs from prebuilt binaries — no compiler toolchain needed.\n- This package is the **try-it / local** path. For a production deployment (TLS, reverse proxy, volume backups), use the [Docker self-host](https://github.com/alacrity-ai/kbRelay/tree/main/infrastructure/docker) — same codebase, same database format.\n\n## License\n\n[Elastic License 2.0](https://github.com/alacrity-ai/kbRelay/blob/main/LICENSE.md) — use it, modify it, build on it; don't offer kbRelay itself as a managed service. Commercial licensing: leif@lalalimited.com.\n","readmeFilename":"README.md","_rev":"1-03f4841df4900a50f6dde018396fa27c"}