tesseract-agent 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# tesseract-agent
+
+Run your **tesseract** agents on a remote machine. Install this on a headless
+Linux server (or in Docker) to make that box available to your tesseract account —
+your laptop, phone, or the web app can then run agents on it, even with no GUI and
+even when nothing else is open.
+
+It's the headless counterpart to the desktop app's "share this machine" hosting:
+the same agent runtime, no Electron.
+
+## Install
+
+```bash
+npm i -g tesseract-agent
+```
+
+Requires Node 20+. Hosting is a paid-plan feature — a Free account will be denied
+and the daemon backs off.
+
+## Use
+
+```bash
+tesseract-agent login            # sign in + provision this machine (device token)
+tesseract-agent install          # run as a background service (systemd; add --system for a root unit)
+tesseract-agent status           # is it running / connected?
+tesseract-agent logs             # tail the service logs
+tesseract-agent logout           # revoke this device + remove the service
+```
+
+`login` takes `--token <jwt>` (or interactive email/password — set
+`CCB_LOGIN_PASSWORD` to script it), plus `--api` / `--relay` to point at a
+self-hosted backend (default: `https://tesseract.fineguide.ai`).
+
+### Docker / no systemd
+
+```bash
+tesseract-agent login --token "$TESSERACT_TOKEN"
+tesseract-agent run              # run the daemon in the foreground
+```
+
+The agent runs under the machine's own Claude credentials — a `claude` login in
+`~/.claude`, or an `ANTHROPIC_API_KEY` in the environment.