Quantext reads the session logs of coding agents (Claude Code first), rebuilds exactly what the model received on every call, and shows where the context tokens go: in a live web viewer, in a status line inside the harness, and to agents through SQL and a CLI. Nothing leaves the machine.
Status: early release (0.1). Claude Code only, macOS and Linux. Expect rough edges; see known issues.
- A status line in Claude Code:
qx $3.42 · ctx 182k · cache 96%, from the harness's own numbers. - Nudges (toasts, never added to the model's context): the prompt cache expired after idle time and the next call re-wrote it; the context passed 200k.
/clear-tools [outputs] [keep N]: compacts by replacing old tool calls (their inputs) and old tool outputs with short stubs instead of a summary, in one pass, so the prompt cache is written once.outputsclears only the outputs;keep Nleaves the last N whole. Also as/compact tools [outputs] [keep N]. The next call writes the whole new context to the cache again; the toast gives that cost and after how many calls the smaller context pays it back, so a clear pays most right after the cache expired. A run with nothing to clear changes nothing. Small inputs (300 chars or less) and ToolSearch results stay whole./quantext view: opens a live viewer onhttp://127.0.0.1:4747with every session on the machine:- the context of each call, exactly as the model received it (system prompt, tool schemas, messages), with the tokens and cost of each block, and what was read from the cache or written to it;
- what changed since the previous call, and why the cache broke;
- each call's answer, tool calls and their lifetime cost, compactions, subagents, project memory;
- short explainers of the concepts (press
g).
claude plugin marketplace add maxsoldev/quantext
claude plugin install quantext@quantextThen start a new Claude Code session (or run /reload-plugins) and type /quantext view. The viewer needs Node
≥ 22.18 or Bun on your PATH; the status line and the commands work without them. The first start reads all your
transcripts once (about 30 s per GB). The engine stops by itself 10 minutes after the last viewer tab closes.
To update: claude plugin update quantext@quantext, then start a new session. To remove:
claude plugin uninstall quantext@quantext and rm -rf ~/.quantext. Each release has a tarball with build
provenance (gh attestation verify <tarball> --repo maxsoldev/quantext) and CycloneDX SBOMs.
From source, for development:
git clone https://github.com/maxsoldev/quantext.git && cd quantext
npm i -g corepack@latest && corepack enable # Node ≥ 22.18; skip if Corepack is already enabled
pnpm install && pnpm build:plugin # builds dist/plugin: the mod, the engine and the viewer
claude plugin marketplace add ./dist # marketplace quantext-dev, read in place
claude plugin install quantext@quantext-devAfter a change: pnpm build:plugin, then /reload-plugins.
Quantext is fully local. It has no telemetry, no analytics, no update checks and no crash reporting, and it makes no outbound connections.
- Reads, read-only: Claude Code's transcripts and memory files under
~/.claude(orCLAUDE_CONFIG_DIR). - Writes only
~/.quantext/(folder 0700, files 0600). - Network: one HTTP server on
127.0.0.1, for the viewer. The mod talks only to it.
CI enforces this on the files we ship: a static no-egress guard reads the built plugin, and the engine's smoke test runs with a network tripwire.
Small supply-chain surface.
- The engine and the mod have no third-party runtime dependencies: only Node and Bun built-ins.
- The viewer bundles five well-known packages: React, react-dom and scheduler (MIT), and the Atkinson
Hyperlegible fonts (OFL-1.1). The plugin's
THIRD_PARTY_NOTICES.mdlists them with their licence texts. - Build tools (TypeScript, Vite, Rolldown, Vitest, Biome) are not shipped. A compromised build tool could still change the bundle, so every package is pinned in the lockfile, comes from the npm registry with an integrity hash and a verified registry signature, waits a day after release before we take it, and may not run an install script. CI also checks for known vulnerabilities and licences, and the no-egress guard checks what the build produced.
Details, and how to report a vulnerability: SECURITY.md.
-
Node ≥ 22.18. Bun 1.3 or later to run the tests under Bun too.
-
pnpm through Corepack. Node 25 and later ship without Corepack, so install it first:
npm i -g corepack@latest && corepack enable pnpm install pnpm check # lint, types, tests, layer check, scans pnpm check:bun # the runtime-specific checks under Bun pnpm build # the viewer (Vite) and the engine bundle, with the viewer in dist/web pnpm e2e # build, then the viewer's Playwright tests (once: pnpm exec playwright install chromium)
Viewer development: run an engine (
pnpm qx serve …), thenQX_ENGINE=http://127.0.0.1:<port> pnpm -F @quantext/web dev; Vite proxies/apiand/healthto it.An older global pnpm may fail to switch itself to the pinned version. Then run
corepack pnpm …instead.
- Architecture: layers, domain model, release plan, quality bar.
- Glossary and decision records.
- Known issues: what we know is wrong or missing, and chose to defer.
- Working rules for contributors and coding agents.
- Security: what Quantext reads, writes and sends, and how we check it.
Licence: Apache-2.0.
