contextune

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