​
Usage Calculation Logic & Cloud Plan Structure

​
Overview

ByteRover tracks memory retrieval requests and enforces monthly limits based on your team’s subscription plan. This system ensures fair usage across different plan tiers.

​
Cloud Plans & Limits

PlanMonthly LimitDescription
Hobby (Free)200 retrievalsDefault free tier
Pro1,000 retrievalsIndividual/small team plan
Team15,000 retrievalsLarger team plan

​
How Usage is Tracked

​
What Counts as Usage

  • Memory retrieval operations through MCP

​
Billing Periods

For Paid Plans (Pro/Team)
  • Usage resets monthly from subscription start date
  • Example: Subscription started Jan 15th → resets on 15th of each month
  • Canceled plans continue using paid limits until subscription ends
For Hobby Plan (Free)
  • Usage resets monthly from team creation date
  • Example: Team created Jan 10th → resets on 10th of each month

​
Usage Enforcement

​
When Limits are Reached

When you exceed your plan’s monthly limit:
  • API requests return a 429 “Usage Limit Exceeded” error
  • Memory operations are temporarily blocked
  • You’ll receive this error message:
{
  "error": "Usage Limit Exceeded",
  "message": "You have exceeded the memory retrieval limit for your plan during the current billing cycle. Please upgrade your plan to continue accessing memories.",
  "currentUsage": 1000,
  "limit": 1000
}

​
Usage Warnings

You’ll see usage warnings in your dashboard when:
  • You’re on the Hobby plan and approaching limits
  • Usage exceeds 90% of your monthly allowance
  • Upgrade prompts will appear to help you continue service

​
Managing Your Usage

​
Monitoring Usage

Track your current usage in the team dashboard:
  • View total retrievals for current billing period
  • See usage breakdown by space (Team plan only)
  • Monitor approaching limits with visual indicators

​
Plan Upgrades

When you upgrade your plan:
  • New limits take effect immediately
  • Current usage counting continues
  • Next billing cycle uses upgraded plan benefits

​
Best Practices

  • Monitor usage regularly through your dashboard
  • Consider upgrading before hitting limits during critical work periods
  • Use space-level permissions to control team member access
Need help with usage management? Contact our support team for assistance with plan selection and usage optimization.