Release list

codex-tldraw-mcp v0.4.0 Latest

Latest

jananadiw released this 16 Jul 20:48

v0.4.0

424a0e3

codex-tldraw-mcp v0.4.0

Code graph drift detection for repo-local tldraw boards.

Highlights

Adds diagram_code_graph for deterministic JavaScript and TypeScript module/import diagrams.
Adds compare_code_graph with a read-only preview and optional board markers.
Marks stale modules and imports red and changed modules orange.
Reports new graph elements without rearranging the existing canvas.
Preserves user positions, sizes, labels, manual shapes, unrelated diagrams, and each element's prior color for restoration.
Restores the original style when the code matches the stored graph again.
Uses the TypeScript parser so JSX text, comments, strings, and regular-expression literals do not create false imports.

How It Works

Generated graph nodes and edges carry stable repository-relative identities and semantic fingerprints. A later scan compares the current modules and local imports with that stored baseline:

unchanged: identity and fingerprint match.
changed: a module remains, but its exports or local import relationships differ.
stale: the board element no longer exists in the current graph.
new: the current graph element is absent from the board.

Preview mode leaves the .tldr file untouched. Marker mode updates only MCP-owned graph styles and metadata. It does not insert new elements or change the canvas layout.

Supported Graphs

The scanner supports .js, .jsx, .mjs, .cjs, .ts, .tsx, .mts, and .cts modules. It follows static imports, dynamic imports, re-exports, and CommonJS require calls between repository modules. It reports unresolved relative imports and counts external imports without drawing external packages.

This release models module/import relationships. It does not infer runtime call graphs, and it cannot compare legacy workflow or prompt-generated diagrams that lack code-graph metadata.

Try It

Use codex-tldraw to create a code graph for this repo.

After changing the code:

Use codex-tldraw to preview drift in the newest code graph. If the result looks right, apply the markers.

Verification

bun install --frozen-lockfile
bun run build
bun run smoke
bun run check:package
mcp-publisher validate

Assets 2

codex-tldraw-mcp v0.3.0

jananadiw released this 11 Jul 01:21

v0.3.0

0336f7f

codex-tldraw-mcp v0.3.0

Workflow layout update for dense diagrams.

Changes

Wraps node and connector text before rendering.
Sizes nodes from the wrapped text.
Routes connections through separate lanes around nodes.
Uses one final arrowhead for each logical connection.
Adds smoke checks for text fit and connector collisions.

Compatibility

MCP tool names and inputs are unchanged. A logical connection may now use multiple arrow records in the generated .tldr file.

Verification

bun run build
bun run smoke
bun run check:package
mcp-publisher validate

Assets 2

codex-tldraw-mcp v0.2.1

jananadiw released this 10 Jul 23:17

v0.2.1

25e76c7

codex-tldraw-mcp v0.2.1

Diagram readability update for generated tldraw boards.

Highlights

Sizes workflow boxes from their label and detail text instead of forcing every step into a fixed rectangle.
Uses readable sans-serif text for generated titles, step labels, and arrow labels.
Wraps larger diagrams into rows while keeping compact diagrams with six or fewer steps on a single row.
Routes arrows from actual step bounds so resized boxes still connect cleanly.
Improves appended diagram spacing by calculating board bounds from real shape and arrow endpoints.
Keeps demo media on GitHub instead of shipping it in the npm tarball, substantially reducing install size.
Validates package contents and size before publishing through npm trusted publishing.

Why This Matters

Generated architecture diagrams could become difficult to read when labels were long or when workflows had many implementation-level connections. This release makes the default .tldr output cleaner, especially for prompt-driven architecture sketches and repo-derived diagrams with longer step details.

Try It

codex mcp add codex-tldraw -- npx -y codex-tldraw-mcp

Use codex-tldraw to draw the runtime architecture:
Menu bar app -> Scheduler -> Snapshot capture -> Vision analysis -> App state -> User alert

The generated board is written to:

<repo>/boards/main.tldr

Verification

bun run build
bun run smoke
bun run check:package
mcp-publisher validate

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

codex-tldraw-mcp v0.1.1

Discoverability update for the Codex-first tldraw MCP server.

Highlights

Adds GitHub/npm metadata so package pages and MCP directories can link back to the repository, issues, and README.
Adds mcpName and root server.json metadata for publishing to the official MCP Registry as io.github.jananadiw/codex-tldraw-mcp.
Moves the README demo image, install command, and generated board path above the compatibility backstory.
Adds CI for build and smoke-test verification on pushes and pull requests.
Adds GitHub issue templates for bugs, feature requests, and real-world feedback.
Keeps the runtime behavior unchanged from 0.1.0.

Try It

codex mcp add codex-tldraw -- npx -y codex-tldraw-mcp

Use codex-tldraw to diagram this repo.

Releases: jananadiw/codex-tldraw-mcp

Release list