@factiii/runner 0.0.1

package/Dockerfile.claude

@@ -0,0 +1,11 @@
+FROM node:20-alpine
+RUN apk add --no-cache git bash sudo curl
+RUN adduser -D claude && echo "claude ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers
+RUN npm install -g @anthropic-ai/claude-code@~2.1.0
+RUN mkdir -p /cache && chown claude:claude /cache
+
+# frpc is `docker cp`'d in at runtime by the runner (only when public previews
+# are enabled). See shared/all/helpers/card-ai/frpc.ts.
+
+USER claude
+WORKDIR /home/claude

package/README.md

@@ -0,0 +1,37 @@
+# @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
+
+```bash
+npm install -g @factiii/runner
+```
+
+Or run without installing:
+
+```bash
+npx @factiii/runner setup
+```
+
+## Usage
+
+```bash
+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 config
+```
+
+`setup` 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.