| 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