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