name: managing-cache-and-optimization description: Use when managing Shannon CLI performance and costs - check cache statistics, clear stale entries, set budgets, understand automatic model selection and cost optimization
Managing Cache and Optimization
Overview
Shannon CLI provides automatic caching and cost optimization across all operations.
Cache Management
Check statistics:
shannon cache stats
Shows: Hit rate, size, savings (USD and time)
Clear cache:
shannon cache clear # All caches
shannon cache clear --type analysis # Just analysis cache
Cache layers (3 tiers):
- Analysis: 7-day TTL
- Command: 30-day TTL
- MCP: Indefinite
Performance targets:
- Hit rate: >60% (good), >80% (excellent)
- Cache speed: <500ms
- Size: <500MB total
Cost Optimization
Set budget:
shannon budget set 10.00 # $10 limit
shannon budget status # Check spending
Automatic model selection:
- Simple tasks → haiku (cheapest)
- Complex tasks → sonnet (balanced)
- Auto-selected per complexity
View optimization:
shannon optimize
Shows: Potential savings, model recommendations
Quick Reference
| Command | Purpose |
|---|---|
| cache stats | View hit rates and savings |
| cache clear | Clear stale entries |
| budget set N | Set spending limit |
| budget status | Check remaining budget |
| optimize | View cost-saving suggestions |
When to Clear Cache
- After Shannon Framework updates
- Cache size >400MB
- Hit rate <40% (stale entries)
- Debugging cache-related issues