Frequently asked questions
Understand the boundary before you measure the gain.
Capsule is deliberately explicit about what it can observe, what it keeps recoverable, and when it refuses to compact a result. These answers are a concise starting point; the source and benchmark files are the authority.
What does Capsule reduce?
Capsule reduces the model-visible representation of eligible terminal output, file reads, project exploration, web results, memory recalls, and repeated context. It keeps the complete local result available for exact recovery.
Does it guarantee lower provider billing or quotas?
No. Local model-visible reduction is not the same as provider billing or subscription-limit reduction. Capsule cannot see hidden reasoning, provider caching, or quota counters. See the benchmark methodology for the reporting boundary.
Is the compact view lossless?
The view is bounded, but the original result is archived locally and addressed by a verified capsule identifier. Use expand only when exact omitted evidence is needed. A changed source invalidates replay.
What happens when compaction is unsafe or larger?
Small, explicit-full, failed, ambiguous, unsupported, unsafe, and token-negative cases pass through. The safety rule is monotonic: a wrapper must not make a result larger or hide a failure.
Can it coexist with other skills and MCP servers?
Yes. Capsule keeps a bounded control surface and routes an installed skill only when the query matches with sufficient confidence. Browser, document, media, and application tools stay separate when their technical capability is required.
Why can a skill route return no match?
No match is an intentional safety result for generic, ambiguous, or weak-overlap queries. The normal task path remains available instead of loading an unrelated specialist catalog. See the MCP context guide.
How do I measure my own workload?
Run npm run verify and the workload-specific commands in BENCHMARK.md. Compare the same baseline and Capsule input, visible bytes or token estimates, recovery success, latency, and fallback cases.
Where does it run and where can I ask for help?
Capsule supports Windows, macOS, and Linux with Node.js 18 or newer. Review SECURITY.md before enabling it on a sensitive workspace. Ask workflow questions in Discussions and report reproducible defects in Issues.