---

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:

Copyshannon cache stats

Shows: Hit rate, size, savings (USD and time)

Clear cache:

Copyshannon 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:

Copyshannon 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:

Copyshannon optimize

Shows: Potential savings, model recommendations

Quick Reference

When to Clear Cache

• After Shannon Framework updates
• Cache size >400MB
• Hit rate <40% (stale entries)
• Debugging cache-related issues