Entroly

Entroly — Select AI context with auditable recovery.

Receipt-backed selection records: what was kept, what was omitted, and the handle that recovers the exact original bytes.

Compression you can undo, on your own repository, in one command — without replacing your model or agent architecture.

pip install -U entroly · entroly verify-claims · entroly simulate

Entroly is an open-source, local-first AI token-efficiency and Context Assurance layer: budgeted evidence selection, recoverable context compression, content-addressed evidence recovery, and auditable receipts. Works through VS Code, Claude Code, Cursor, Codex, OpenClaw, GitHub Copilot, Aider, and OpenAI/Anthropic-compatible apps.

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · हिन्दी · Français · Deutsch · Português · Italiano · Türkçe · Tiếng Việt · Bahasa Indonesia · Polski · Nederlands · ไทย · Svenska · Čeština · Tagalog · Română

What is it? · Install · Quickstart · Benchmarks · Questions · Contribute

---

What is Entroly? (in plain English)

Entroly is a local-first context control plane for AI coding tools. It selects evidence within a token budget, preserves recoverable omissions, and records selection decisions in receipts. Three properties to evaluate on your task:

Do I have to change my code? No. On hosts with a verified prompt hook, Entroly runs before the model plans. MCP-only integrations remain callable tools that an agent may skip; API traffic is intercepted only when it is routed through the Entroly proxy. Check entroly activation status --json instead of assuming an installed integration is active.

Do I need to pay for anything to try it? No. The two commands in the Install section below run on your own machine, with no API key, and show you real numbers on your own project before you connect anything paid. (Missing native-engine support is reported without downloading packages — see the note under Install.)

Switching coding agents mid-task? entroly-work resume reconstructs unfinished work from durable repository evidence, even if the previous agent left no handoff. The receiving agent must review the inferred state and acknowledge it before claiming work through Entroly. Start with entroly-work --project . --json resume --to-agent codex; the agent continuity guide shows the complete flow and how to measure whether it actually saves rediscovery work on your tasks.

---

Contributing

Start with development setup and repository layout, then follow the architecture, style guide, and test instructions for the surface being changed. Source, delivery adapters, and benchmark evidence have different review requirements; the contributor guide explains their boundaries.

Install

Not sure which one? Pick Python. It's the complete version and what

most people use. The other packages expose different runtime surfaces.

Prefer a package runner instead of a global install? These commands use the same published artifacts in an isolated tool cache:

# Node or Bun / WASM runtime

npx -y entroly@latest --help pnpm dlx entroly@latest --help bunx --bun entroly@latest --help

Complete Python runtime

uvx --from entroly entroly --help pipx run --spec entroly entroly --help

The Node commands provide the local WASM CLI. The Python commands provide the complete CLI, SDK, MCP, proxy, verification, and native-engine path described above. Entroly's release workflow smoke-tests all five runners against the exact version before a release is considered complete.

Now check that it worked — free, no API key:

cd /your/repo

entroly verify-claims entroly simulate

Both run locally. Neither calls an AI or proves answer quality, activation, or a lower provider bill. Use a task-specific --query with simulate; if it reports Relevance ranking is OFF, run entroly doctor before evaluating the selection.

Runtime package repair is off by default. If the native engine is missing, query-conditioned selection is unavailable and reduction figures are labelled unearned. Install it explicitly with python -m pip install -U entroly-core, call entroly.repair() from Python, or set ENTROLY_ENABLE_SELF_HEAL=1 to permit startup repair. This downloads through the configured package index (normally PyPI). ENTROLY_NO_SELF_HEAL=1 and ENTROLY_AIR_GAP=1 override repair consent. See Privacy and recovery-data security.

Extras (entroly[proxy], entroly[native], entroly[full]), the standalone Rust binary, and uninstall steps: Engine & install options.

Contributing from source? Follow the reproducible development setup. Local installation and the normal test suite need no API key; .env.example documents only optional workspace, offline, provider, and proxy settings.

---

Quickstart — by how you work

Start with the [local check](#install). entroly go registers an MCP

server for a detected editor and starts a proxy and dashboard. Route API

traffic through that proxy or use a supported host hook, then verify that

the integration actually ran. The table below shows the available paths.

| "I use another MCP host." | entroly attach create --client claude --project . --ttl 4h --install or the client-specific command in the compatibility matrix | Scoped Entroly tools and receipts;