Skip to content

codex-tldraw-mcp v0.2.0

Choose a tag to compare

View all tags
@jananadiw jananadiw released this 30 Jun 20:03
v0.2.0
d0c9ed5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

codex-tldraw-mcp v0.2.0

Offline canvas API update for Codex-first tldraw diagrams.

Highlights

  • Adds draw_canvas, a new MCP tool for drawing prompt-provided workflows, state machines, architecture sketches, and plans.
  • Keeps diagram_repo for repo-inferred product workflow diagrams.
  • Stores every generated diagram as a repo-local .tldr snapshot under boards/.
  • Appends new diagrams to the right of existing board content instead of clearing the board.
  • Generates stable step ids from labels when callers do not provide ids.
  • Validates duplicate step ids and connection references before writing the board.

Why This Matters

The project started as a Codex-first fallback for environments where live embedded tldraw canvas control is unavailable or unreliable. draw_canvas keeps that reliability while expanding the use case beyond repo scanning: users can now ask Codex to draw any described flow into a tldraw-compatible board file.

Try It

codex mcp add codex-tldraw -- npx -y codex-tldraw-mcp
Use codex-tldraw to draw a password reset state machine:
Idle -> Reset requested -> Email sent -> Token verified -> Password updated.

The generated board is written to:

<repo>/boards/main.tldr

Verification

bun run build
bun run smoke
npm publish --access public --dry-run

Links

Assets 2
Loading