Progressive disclosure harnesses
Formats, runtimes, and patterns that reveal context, tools, or instructions in layers—index first, details on demand—to control tokens and improve agent focus (the "map, not encyclopedia" principle).
| # | Project | Stars | Tier | OSS | Description |
|---|---|---|---|---|---|
| 1 | Headroom mcprag | 64k | mostly simple | ✅ | Compresses tool outputs, logs, files, and RAG chunks with content-aware compressors before they reach the model—claimed 20% fewer tokens for coding agents and 60–95% fewer for JSON, same answers. Ships as a library, HTTP proxy, or MCP server, so it drops in front of whatever harness you already run. |
| 2 | awesome-cursorrules ide | 40.5k | super simple | ✅ | Curated .cursorrules and skills that leverage Cursor's index-then-load model; the canonical collection for rules-as-progressive-disclosure in the IDE. |
| 3 | agents.md typescript | 23.4k | super simple | ✅ | Open format for repo-scoped agent briefings; v1.1 adds hierarchical scope and progressive disclosure so agents get a map of what exists, then load only what's relevant. |
| 4 | context-mode mcpmemorysandbox | 19.6k | mostly simple | ❓ | Context-window optimization layer that sandboxes tool output before it reaches the model (claimed 98% reduction) and persists session memory across 17 agent platforms via MCP and hooks—progressive disclosure applied to tool results, not just instructions. |
| 5 | langgraph-bigtool tool-discoverypython | 552 | slightly complex | ✅ | Build LangGraph agents with large tool sets; retrieval and on-demand tool loading so agents scale beyond context without stuffing every schema upfront. |
| 6 | MCP-Zero tool-discovery | 503 | complex | ✅ | Active tool discovery for autonomous agents: model requests tools by requirement; hierarchical semantic routing over 308 servers / 2,797 tools with ~98% token reduction (APIBank). |
| 7 | ToolGen tool-discoverypython | 183 | complex | ❓ | ICLR 2025: unified tool retrieval and calling via generation; 47k+ tools without context stuffing—retrieval and invocation in one generative step. |
| 8 | ToolRAG mcptool-discovery | 29 | mostly simple | ✅ | Semantic tool retrieval for LLMs; serves only the tools the user query demands (MCP-compatible), unlimited tool sets with zero context penalty. |