From 7e36ebcc6666ea4427803a18b021c1829c67921b Mon Sep 17 00:00:00 2001 From: Rizel Scarlett Date: Tue, 17 Mar 2026 02:28:17 -0400 Subject: [PATCH] docs: add credit balance monitoring section (#7952) Signed-off-by: Rizel Scarlett --- .../guides/sessions/smart-context-management.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/documentation/docs/guides/sessions/smart-context-management.md b/documentation/docs/guides/sessions/smart-context-management.md index a6598ce6cf..7289485041 100644 --- a/documentation/docs/guides/sessions/smart-context-management.md +++ b/documentation/docs/guides/sessions/smart-context-management.md @@ -365,6 +365,23 @@ export GOOSE_PLANNER_MODEL="gpt-4-custom" export GOOSE_PLANNER_CONTEXT_LIMIT=1000000 ``` +## Credit Balance Monitoring + +goose monitors your API provider balance and warns you when credits are running low or exhausted. When this happens, you'll see an **Insufficient Credits** notification. + +For providers that support it (such as [Tetrate Agent Router Service](https://router.tetrate.ai)), the notification includes an **Add credits** button that takes you directly to your provider's billing page. + +**What to do:** +1. Click the **Add credits** button (if available) to top up your account +2. Or visit your provider's dashboard manually to add credits +3. Once credits are added, resend your message to continue the conversation + +:::tip +goose detects low balance conditions automatically, so you won't lose your conversation context—just add credits and pick up where you left off. +::: + +**Supported providers:** Tetrate Agent Router Service, OpenRouter, and other providers that report balance information via HTTP 402 responses. + ## Cost Tracking Display real-time estimated costs of your session.