@factiii/runner
v0.0.1
Published
Factiii Runner, run Board AI agents on a machine you control. Pairs with the Factiii web/mobile clients over WebRTC.
Downloads
87
Readme
@factiii/runner
A headless daemon that runs Factiii's Board AI agents (Claude-driven coding sessions) on a machine you control. Install it on a workstation, dev box, or VM that has Docker and a stable network connection. The mobile and web Factiii clients then connect to it over WebRTC and offload AI work.
Requirements
- Node 20+
- Docker (running and reachable via
docker info) - A Factiii account
- Outbound network access to the Factiii API server
Install
npm install -g @factiii/runnerOr run without installing:
npx @factiii/runner setupUsage
factiii-runner setup # verify docker, build the claude image, pair this runner
factiii-runner connect # re-pair with a different account
factiii-runner start # run the daemon (keep this process alive)
factiii-runner status # show current configsetup is the one-shot command that gets you from zero to running. It checks Docker, builds the factiii-claude image, and walks you through the browser pairing flow. After it finishes, factiii-runner start runs the daemon.
Security notes
Tokens (Claude OAuth, GitHub PAT) are stored unencrypted at ~/.factiii-runner/config.json. Anyone with shell access to this machine as the same user can read them. Only run a runner on a machine you trust, and only pair with accounts you own.
