wtf is compress?

@tokz/compress is a local tool that helps AI coding agents avoid wasting effort reading entire files when they only need a few specific functions from them. It runs as an MCP server, a kind of local plugin that AI coding tools like Claude Code, Cursor, or Codex can call, and instead of handing the agent a whole file, it shows a compressed version containing just the parts relevant to what the agent is actually looking for. Everything else in the file is reduced down to a short signature showing that more code exists there, and it can be pulled back in full almost instantly if it turns out to matter after all. The key guarantee is that any code shown to the agent is an exact, byte-for-byte copy of what is really in the file on disk, including correct line numbers, never a summary or a paraphrased version. This is checked automatically every time, and any piece of code that fails that check is simply dropped rather than shown incorrectly. This matters because if an agent tries to edit code based on a paraphrased version that does not exactly match the real file, the edit will fail or, worse, the agent may reason about code that was never actually there. Setup is done through a single command line tool that automatically detects which AI coding tools are installed, such as Claude Code, Cursor, Antigravity, Windsurf, and Codex, and configures each one correctly for its own operating system and expected file paths. It handles some tricky details on its own, like using the correct command form on Windows so it does not fail to launch, and giving Claude Code a special plugin installation that also adds automatic hooks so compression happens without the agent needing to choose to use it. Every configuration change it makes backs up the original file first, and it will not touch a file that is not valid JSON. The project runs entirely on the user's own machine, requires no account, no API key, and no network connection, and is released under the MIT license.