README
Contextune
Precision-Tuned Context Engineering for Claude Code
Optimize context flow with modular plans (95% fewer tokens), parallel workflows (81% cost reduction), and zero-transformation architecture. Contextune your workflows for peak performance!
The Problem
Claude Code has 80+ plugins with hundreds of slash commands. You can't remember them all.
Before Contextune:
You: "I need to run tests"
Claude: "Sure! Running tests..."
[30 seconds later, writes custom test script]
After Contextune:
You: "I need to run tests"
Contextune: 🎯 Auto-executing /sc:test (85% confidence, keyword match, 0.02ms)
Claude: [Executes /sc:test automatically]
🚀 NEW in v0.9.0: Context Engineering Framework
Complete context optimization with session duration tracking, usage monitoring, and smart tool routing
Contextune v0.9.0 introduces comprehensive context engineering features that maximize session duration and minimize costs.
📊 Session Duration Tracking (NEW)
Measure context preservation effectiveness:
# View session metrics
./scripts/view_session_metrics.sh
# Example output:
Session: session_1730000000
Started: 2025-10-26 21:00:00
First Compact: 2025-10-26 21:28:00
Duration: 28.0 minutes
Status: ✅ Good context preservation
Thresholds:
- ⚠️ Short (<10 min): Needs optimization
- ✅ Good (10-30 min): Healthy usage
- 🎯 Excellent (30+ min): Excellent preservation
💰 Usage Monitoring & Optimization (v0.8.9)
Automatic cost optimization based on quota consumption:
- At 90% weekly usage: Auto-switch to Haiku (87% savings)
- Parallel task limits: 2 concurrent at high usage
- Three-tier fallback: Headless → Estimation → Manual paste
Track usage:
/usage # Claude Code's usage command
/contextune:usage # Paste output to track in Contextune
⚡ Smart Tool Routing (v0.9.0)
Intelligent delegation of expensive operations:
- Read >1000 lines → Delegate to Haiku
- Complex Bash → Delegate to Haiku
- Fast operations → Keep on Sonnet
Cost savings: 77-87% per delegated operation Context benefit: 3x longer sessions before compaction
🚀 v0.3.0: Haiku Agent Architecture
81% cost reduction + 2x speedup with three-tier intelligence
Contextune v0.3.0 introduces cost-optimized Haiku agents that dramatically reduce parallel workflow costs while improving performance.
💰 Cost Optimization
Before (All Sonnet):
5 parallel tasks: $1.40 per workflow
1,200 workflows/year: $1,680/year
After (Haiku Agents):
5 parallel tasks: $0.27 per workflow (81% cheaper!)
1,200 workflows/year: $328/year
Annual savings: $1,356 💰
⚡ Performance
- Response time: 2x faster (Haiku 1-2s vs Sonnet 3-5s)
- Quality: Identical for execution tasks
- Scalability: Same 200K context window
🤖 5 Specialized Haiku Agents
parallel-task-executor - Feature implementation ($0.04 vs $0.27)
Autonomous development task execution:
- Creates GitHub issue and worktree
- Implements features
- Runs tests
- Pushes code and reports
Cost per task: $0.04 (85% savings!)
worktree-manager - Git worktree lifecycle ($0.008 vs $0.06)
Expert worktree management:
- Create/remove worktrees
- Diagnose lock file issues
- Bulk cleanup operations
- Health checks
Cost per operation: $0.008 (87% savings!)
issue-orchestrator - GitHub operations ($0.01 vs $0.08)
GitHub issue management:
- Create/update/close issues
- Label management
- Link to PRs
- Bulk operations
Cost per operation: $0.01 (87% savings!)
test-runner - Autonomous testing ($0.02 vs $0.15)
Multi-language test execution:
- Run tests (Python, JS, Rust, Go)
- Generate reports
- Create issues for failures
- Track coverage
Cost per run: $0.02 (87% savings!)
performance-analyzer - Workflow optimization ($0.015 vs $0.12)
Performance and cost analysis:
- Benchmark workflows
- Identify bottlenecks
- Calculate ROI
- Generate reports