gh-shakes-tzd-contextune/commands/ctx-usage.md

name, description, keywords

name	description	keywords
ctx:usage	Track and optimize context usage with intelligent recommendations	usage context limits quota optimization

/ctx:usage - Context Usage Optimization

Track your Claude Code usage and get intelligent recommendations for cost optimization.

Usage

Quick Check (Manual Input)

# 1. Run Claude Code's built-in command:
/usage

# 2. Then run this command to log it:
/ctx:usage

Claude will ask you to paste the /usage output, then provide:

• ✅ Current usage status
• ⚠️ Warnings if approaching limits
• 💡 Recommendations (model selection, parallel tasks, timing)
• 📊 Historical trends

Automatic Tracking

Contextune automatically estimates your token usage based on:

• Prompt lengths
• Response sizes
• Haiku vs Sonnet usage
• Parallel task spawning

Example Output

📊 Context Usage Analysis

Current Status:
  Session: 7% (resets 12:59am)
  Weekly: 89% (resets Oct 29, 9:59pm)
  Opus: 0% available

⚠️  Warnings:
  • 89% weekly usage - approaching limit
  • Reset in: [time remaining]

💡 Recommendations:
  • Switch research tasks to Haiku (87% cost savings)
  • Max parallel tasks: 2 (based on remaining context)
  • ✨ Opus available (0% used) - great for complex architecture
  • Defer non-critical tasks until weekly reset

📈 Estimated Savings:
  • Using Haiku for next 5 tasks: ~$0.45 saved
  • Waiting until reset: +11% weekly capacity

Integration with Other Commands

/ctx:research

Automatically uses Haiku when weekly usage > 80%

/ctx:plan

Limits parallel tasks based on available context

/ctx:execute

Defers execution if approaching session limits

Manual Update

If you want to manually log usage data:

/ctx:usage --update

Then paste your /usage output when prompted.

Dashboard

View historical trends:

marimo edit notebooks/contextune_metrics_dashboard.py

The dashboard shows:

• Usage trends over time
• Cost savings from optimization
• Model selection patterns
• Parallel task efficiency