provider-limits

Provider Usage Limits Configuration

Configure token usage limits for each provider. When a provider reaches its limit, the system automatically switches to the next provider in the priority list.

Usage

View All Limits

/provider-limits

Set Limits for a Provider

/provider-limits <provider> --daily <limit> --monthly <limit>

Examples

# Set Anthropic limits to 1M daily, 10M monthly
/provider-limits anthropic --daily 1M --monthly 10M

# Set Bedrock with higher limits
/provider-limits bedrock --daily 5M --monthly 50M

# Set OpenRouter limits
/provider-limits openrouter --daily 500K --monthly 5M

Limit Format

Limits can be specified in multiple formats:

Format	Example	Value
Raw number	1000000	1,000,000 tokens
K suffix	500K	500,000 tokens
M suffix	1M	1,000,000 tokens
Unlimited	0 or unlimited	No limit

Implementation

When this command is invoked:

1. Parse provider and limit arguments
2. Convert limit strings to numbers
3. Update configuration in ~/.opencode/provider-fallback/config.json
4. Display updated limits

Parse Limit Helper

function parseLimit(value) {
  if (!value || value === 'unlimited') return 0;
  
  const str = value.toString().toUpperCase();
  
  if (str.endsWith('M')) {
    return parseFloat(str) * 1000000;
  } else if (str.endsWith('K')) {
    return parseFloat(str) * 1000;
  }
  
  return parseInt(str, 10);
}

Display Current Limits

const { loadConfig } = require('${CLAUDE_PLUGIN_ROOT}/lib/providers.js');
const config = loadConfig();

console.log('\n=== Provider Usage Limits ===\n');

for (const [provider, limits] of Object.entries(config.usageLimits)) {
  const daily = limits.dailyTokens === 0 ? 'Unlimited' : limits.dailyTokens.toLocaleString();
  const monthly = limits.monthlyTokens === 0 ? 'Unlimited' : limits.monthlyTokens.toLocaleString();
  
  console.log(`${provider}:`);
  console.log(`  Daily:   ${daily} tokens`);
  console.log(`  Monthly: ${monthly} tokens`);
  console.log('');
}