Skip to content

Conversation

@ethanpalm
Copy link
Collaborator

@ethanpalm ethanpalm commented Jan 23, 2026

Documentation changes

This PR updates the assistant docs based on recent updates to assistant message tier billing.

Closes


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Note

Updates assistant documentation to reflect new billing model and management UI.

  • Documents tiered message allowances with carryover and defines what counts as a message
  • Clarifies that overages are allowed by default and can be disabled; adds guidance on costs and availability when limits are reached
  • Rewrites management copy to point to Assistant Configurations pages and simplifies configuration instructions
  • Refines billing section with updated upgrade/downgrade effects (immediate allowance updates, proration, no carryover on downgrade)
  • Removes outdated configuration screenshots/frames and adjusts terminology for consistency

Written by Cursor Bugbot for commit fbe8c8c. This will update automatically on new commits. Configure here.

@ethanpalm
Copy link
Collaborator Author

The broken link checker is for the removed images in translated files. It will be fixed when the localization bot runs after this PR is merged.

Copy link
Contributor

@mayankshouche mayankshouche left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just one thing I'd like to change!

Co-authored-by: Mayank Shouche <43075711+mayankshouche@users.noreply.github.com>
@ethanpalm ethanpalm merged commit 02b75d6 into main Jan 25, 2026
4 of 5 checks passed
@ethanpalm ethanpalm deleted the assistant-credit-rollover branch January 25, 2026 23:13
Each message sent to the assistant counts toward your plan's message allowance. If you exceed your allowance, additional messages incur overage charges. You can set spending limits or disable the assistant if you reach your message allowance.
The assistant uses tiered message allowances. A message is any user interaction with the assistant that receives a correct response. If you have unused messages, up to half of your message allowance can carry over to the next billing cycle. For example, if you have a 1,000 message allowance and you use 300 messages, 500 messages carry over to the next billing cycle giving you a total of 1,500 messages for the next billing cycle.

By default, the assistant allows overages. You can disable overages to avoid incurring additional costs for usage beyond your tier. If you reach your message allowance and have overages disabled, the assistant is unavailable until your message allowance resets. Each additional message incurs an overage charge, but occasional overages may be cheaper than upgrading to a higher tier depending on your usage.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor wording tweak: the last sentence reads like overage charges apply even when overages are disabled. Suggest scoping it to the enabled case.

Suggested change
By default, the assistant allows overages. You can disable overages to avoid incurring additional costs for usage beyond your tier. If you reach your message allowance and have overages disabled, the assistant is unavailable until your message allowance resets. Each additional message incurs an overage charge, but occasional overages may be cheaper than upgrading to a higher tier depending on your usage.
By default, the assistant allows overages. You can disable overages to avoid incurring additional costs for usage beyond your tier. If you reach your message allowance with overages disabled, the assistant is unavailable until your message allowance resets. When overages are enabled, each message beyond your allowance incurs an overage charge, but occasional overages may be cheaper than upgrading to a higher tier depending on your usage.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants