TESSEN Platform
Documentation
Docs/Models
MODELS / PROJECT ZERO

ZERO troubleshooting

Each ZERO Alpha failure, what it means, and the fix.

Restricted accessPrivate enrollment.
SymptomFix
tessen: command not foundThe 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.jsThe 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-intessen 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 expiredCodes are short-lived. Run tessen auth:login again.
OpenCode does not list ZERORun tessen opencode again and restart OpenCode. tessen opencode --print shows the configuration it would write.
401 on every requestThe credential was revoked or expired. Run tessen auth:login, then tessen opencode.
403 zero_entitlement_requiredYour account is not enrolled. tessen zero shows your access.
503 zero_capacity_unavailableRead error.limit and wait for reset_at or Retry-After.
503 zero_program_disabledTessen has switched ZERO off, usually during an incident or a change. Nothing on your side needs fixing.

Search documentation

Titles, headings and guides↑ ↓ navigate · Enter open