entities-runtime

A standalone Node.js daemon. Install it on any machine, pair with your +Ai account, and your account can then run Claude Code / Codex sessions on that machine on its behalf — from Vault, from Entity Studio, or from anywhere else in +Ai.

Quick start

npx entities-runtime

The first run prints a 5-letter pairing code and a URL:

Pair this runtime with your +Ai account.

  https://vault.add.ai/entity/connect/HDXYC

Enter this code: HDXYC

Open the URL while signed into Vault, enter the code, and the runtime starts polling for work. Capabilities (claude, codex, git, node) are reported every 30 s.

Commands

entities-runtime                  run the daemon (foreground)
entities-runtime status           pairing + capabilities + last-seen
entities-runtime sessions         recent requests handled (--limit N)
entities-runtime unpair --yes     disconnect from +Ai
entities-runtime version          print version

status and sessions work without the daemon running — they hit Supabase directly using the daemon token in ~/.entities-runtime/state.json.

Architecture

See docs/architecture.md for the full picture: Supabase tables, RPC inventory, request lifecycle, and the cancel-watcher flow.

Development

npm install
npm run build
node dist/cli.js