human-bee/local-tldraw-board

Local tldraw Board is a plugin that gives AI coding agents a persistent visual whiteboard they can edit in real time while you watch in a browser tab. The board uses tldraw, an open-source collaborative drawing tool, running locally on your machine. When an agent makes a change (adding shapes, dropping in screenshots, writing annotations), the edit appears immediately in the browser. The plugin works by running a local web server that hosts the tldraw editor and a separate server that exposes tools to AI agents via MCP (Model Context Protocol, a standard way for agents to call external tools). The agent sends commands to the MCP server, which relays instructions to the browser through a local bridge. Board data and any media on it are saved to a folder on your machine and persist across restarts. The use cases described in the README are tasks like arranging screenshots for a UI comparison, building a visual spec sheet with mockups and notes, or keeping an annotated whiteboard that the agent updates across multiple sessions. Boards can also be exported as images. Installation is supported in three AI coding environments: Codex Desktop (via its plugin marketplace), Claude Code (via slash commands or CLI), and Cursor (via MCP config or a symlink). First-time setup runs Node scripts to install dependencies, optionally register a macOS background service to keep the web server alive between restarts, and open a named board in the browser. All board data stays on your machine and is not sent to external servers unless you explicitly publish the files. The project is released under the MIT license.