context-folding

What problem does it solve?

Context folding addresses context bloat by creating isolated computation branches for complex sub-tasks, each with its own token budget and automatic cleanup on return.

Core Features & Use Cases

• Isolated branching: Create a dedicated context branch for a sub-task to prevent leakage into the main context.
• Budgeted execution: Each branch carries a token budget and timeout, with real-time status checks.
• Safe orchestration: Supports parallel or dependent task workflows with clear return values and memory records.
• Real-world use: Analyzing a large codebase with multiple agents while protecting the main session state.

Quick Start

1. Create an isolated branch: branch_create(session_id: "main", description: "Analyze auth module (sub-task)", budget: 4096)
2. Do work inside the branch, then check status: branch_status("br_abc123")
3. Return results: branch_return(branch_id: "br_abc123", message: "Analysis complete", return_value: { "results": [] })