DOCUMENTATION / PROJECT ZERO
Troubleshooting
Each Project Zero failure, what it means, and the fix.
| 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 for a new one. |
| OpenCode does not list Project Zero | Run tessen opencode again, then restart OpenCode. tessen opencode --print shows the configuration it would write without writing anything. |
| 401 from every request | The credential was revoked or has expired. Run tessen auth:login, then tessen opencode. |
| 403 zero_entitlement_required | Your account does not have Project Zero access yet. tessen zero shows it; see Getting access. |
| 503 zero_capacity_unavailable | The shared pool cannot serve right now or is used for today. Wait for the reset_at time in the error. |
| 503 zero_program_disabled | Tessen has switched Project Zero off, usually during an incident or a change. Nothing on your side needs fixing. |
| Something else | Run tessen doctor and include its output when you report it on https://github.com/TessenLab/zero/issues. |
Refusal codes
| Status | Code | Meaning |
|---|
| 401 | — | The credential is missing, revoked or expired. Run tessen auth:login, then tessen opencode. |
| 403 | zero_entitlement_required | This account does not have Project Zero access. tessen zero shows your access. |
| 422 | — | The request body is invalid — for example an unknown program, or the project-zero model sent together with a different program. |
| 503 | zero_capacity_unavailable | No verified zero-cost capacity can serve the request right now, or today's pool is used. The error carries reset_at; retry after it. |
| 503 | zero_program_disabled | Project Zero is switched off by Tessen. It is not your account and not the pool, and the rest of Tessen is unaffected. |