Repository navigation
Droste 1.3.0 adds progressive code exploration: search a local graph, navigate by node ID, and zoom from map to structure to source within a measured token window.
- New CLI
droste exploreand MCPdroste_explore. - Real
o200k_base/cl100k_basebudgets on the complete compact response, including JSON, source locations, receipts and newline. - One MCP text block, with automatic duplicate structured output disabled.
- Reuse exact unchanged representations only when the client explicitly acknowledges it still retains them. Clear receipts after compaction.
- Verify source hashes and refuse stale or unverifiable snapshots. Show omitted candidates, truncated links and each item's actual detail level.
- Keep the legacy character-budget context API and original galaxy viewer.
Try the recorded interactive demo ? Workflow and limitations
On pinned Requests source, the complete source response for HTTPAdapter.send was 2,500 tokens; a retained revisit returned 827 tokens. Its acknowledgement arguments add 254 tokens (the original arguments add 16). These are selected payload-size observations, not model task success, provider billing or competitor-performance results. Natural-language discovery and dynamic call resolution remain limited.
Validation: 105 regression cases on Linux Python 3.10/3.11/3.12 and Windows Python 3.12; distribution checks; installed-wheel CLI/receipt/HTTP and actual calls to all ten MCP tools, including checking the exact counted single text block. All three public Requests investigations were also checked through the installed wheel. The recorded demo was exercised at desktop and mobile sizes.
python -m pip install --upgrade droste-memory
droste index .
droste explore --tokens 1000The first tokenizer use downloads a small vocabulary; run droste explore --prepare-tokenizers once for later offline use. Token counts cover the returned text under the chosen reference encoding, excluding tool-call arguments, provider wrappers and other session messages. File-size reductions do not establish task quality or lower bills.
Published on GitHub, PyPI and the MCP Registry.