About Waggle
Waggle is a command line tool and MCP server that lets you check whether an AI agent actually read the files it was given. Agents answer with confidence even when they skipped documents, and waggle records which files were opened so you can trust the answer or send the agent back.
It works through a handoff token. You mint a token for a folder, for example with a requirement that all files be read, and pass only that short token to a subagent instead of pasting the contents. The subagent resolves the token into a map of the files with their headings, opens individual files by name, and searches across the whole tree in one call by pattern, symbol or line range. A coverage command then reports how many files were read, whether the requirement was met, and which files stayed unread. Because the folder stays on disk and only the token travels, the same material is not copied into every agent's context window, which the project says cuts what the model has to read by a large factor.
Setup is a single binary installed with Homebrew or a shell script, plus one line that registers waggle as an MCP server in Claude, Codex or Cursor. A shared background daemon starts automatically on first use. The site cites measurements across 1,704 runs and nine models, links a paper and a GitHub repository, and is aimed at developers building multi agent workflows.
No pricing is published; the tool is distributed as an installable package.