From d30338ac12c0a9ea95f9013d0a2b96e705522283 Mon Sep 17 00:00:00 2001 From: Edmon Marine Clota Date: Mon, 17 Aug 2026 20:09:36 +0200 Subject: [PATCH] docs: distinguish trial, global, and daily review limits in troubleshooting The backend now returns three distinct 429 reasons (daily rate limit, TRIAL_REVIEW_LIMIT_REACHED, MAX_REVIEW_LIMIT_REACHED). Split the single 429 troubleshooting row into three so the fix guidance matches: daily -> wait for reset, trial -> upgrade, org ceiling -> contact. Also reword the usage-counter note so it no longer frames the quota as daily-only. --- skills/optibot/SKILL.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/skills/optibot/SKILL.md b/skills/optibot/SKILL.md index a012fc8..017e973 100644 --- a/skills/optibot/SKILL.md +++ b/skills/optibot/SKILL.md @@ -135,7 +135,7 @@ The review output has two sections: **File Comments** — Specific feedback tied to file paths and line numbers. Each comment references the exact file and line range. Use these to navigate directly to the code that needs attention. -**Usage counter** — Shows how many reviews have been used out of the daily limit (e.g., `Reviews used: 3/20 (17 remaining)`). +**Usage counter** — Shows how many reviews have been used out of the applicable review limit (e.g., `Reviews used: 3/20 (17 remaining)`). ## After a Review @@ -159,7 +159,9 @@ The most powerful pattern is reviewing before committing or opening a PR: | Error | Meaning | Fix | |-------|---------|-----| | Authentication failed (401) | Token expired or invalid API key | Run `optibot login` or check `OPTIBOT_API_KEY` | -| Review limit reached (429) | Daily quota exhausted | Wait for reset (shown in error) or contact getoptimal.ai | +| Daily review limit reached (429) | Daily quota exhausted | Wait for the reset shown in the error message | +| Trial review limit reached (429) | The trial's total review allowance is used up | Upgrade at agents.getoptimal.ai/dashboard/billing | +| Review limit reached (429) | The organization's review ceiling has been reached | Contact getoptimal.ai/contact to raise it | | No seat assigned (403) | User not assigned in their org | Ask org admin to assign a seat | | Plan doesn't include reviews (402) | Free/basic plan | Upgrade at getoptimal.ai | | No changes to review | Empty diff | Make some changes first, or use `-b` to compare branches |