Managing Cache and Optimization
Overview
Shannon CLI provides automatic caching and cost optimization across all operations.
Cache Management
Check statistics:
bash
shannon cache stats
Shows: Hit rate, size, savings (USD and time)
Clear cache:
bash
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:
bash
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:
bash
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