MODELS / PROJECT ZERO
ZERO troubleshooting
Each ZERO Alpha failure, what it means, and the fix.
Restricted accessPrivate enrollment.
| Symptom | Fix |
|---|---|
tessen: command not found | The installer puts the CLI in ~/.local/bin. Add it to PATH (export PATH="$HOME/.local/bin:$PATH") or open a new terminal, then run tessen --version. |
| The installer stops on Node.js | The CLI requires Node.js 20 or newer, on macOS, Linux or WSL. Install or upgrade Node.js, then re-run the installer. |
| The browser does not open during sign-in | tessen auth:login prints the approval URL and a short code. Open the URL on any device, sign in, and confirm the code matches. |
| The approval page says the code expired | Codes are short-lived. Run tessen auth:login again. |
| OpenCode does not list ZERO | Run tessen opencode again and restart OpenCode. tessen opencode --print shows the configuration it would write. |
| 401 on every request | The credential was revoked or expired. Run tessen auth:login, then tessen opencode. |
403 zero_entitlement_required | Your account is not enrolled. tessen zero shows your access. |
503 zero_capacity_unavailable | Read error.limit and wait for reset_at or Retry-After. |
503 zero_program_disabled | Tessen has switched ZERO off, usually during an incident or a change. Nothing on your side needs fixing. |