termDRAW: vẽ sơ đồ ASCII ngay trong terminal để prompt agent đỡ tốn token

TL;DR

Ngày 25/04/2026, Ben Vinegar (@bentlegen, co-founder Modem, ex-VPE Sentry) công bố termDRAW — một terminal-native illustrator giúp dev vẽ sơ đồ ASCII + unicode trực tiếp trong terminal để feed cho coding agent (Claude Code, Pi, Codex…). Pitch chính: truyền đạt design intent rõ hơn nhiều so với mô tả bằng chữ, lại tốn ít token hơn screenshot. Repo MIT trên GitHub, ba package npm @termdraw/app, @termdraw/opentui, @termdraw/pi, chạy được qua SSH. Cần Bun 1.3+ và terminal hỗ trợ chuột.

Có gì mới

termDRAW không phải là một ASCII art tool thông thường. Nó là một editor tương tác chạy hoàn toàn trong terminal, output ra plain text (không phải SVG, không phải bitmap), nên kết quả paste thẳng được vào prompt của LLM, vào markdown file, vào PR description, hay code comment.

Có ba cách dùng:

• @termdraw/app — app standalone, cài bằng npm install --global @termdraw/app rồi chạy termdraw.
• @termdraw/opentui — component embed (TermDrawApp, TermDrawEditor) để nhúng vào TUI app dựng bằng OpenTUI hoặc React-Ink.
• @termdraw/pi — extension cho Pi (pi.dev), terminal coding agent của Mario Zechner. Khi cài, người dùng có thể overlay editor lên session đang chạy.

Save tác phẩm bằng Enter hoặc Ctrl+S. Có flag --output để xuất plain text, --fenced để bọc trong markdown code block sẵn sàng paste vào chat.

Tại sao đáng để ý

Hai trong ba cách phổ biến nhất để truyền design intent cho coding agent đều có vấn đề:

• Mô tả bằng chữ ("có 3 service A, B, C, A gọi B, B gọi cả C lẫn cache, …") thường mơ hồ về spatial relationship. Agent đoán sai cấu trúc.
• Screenshot đính kèm thì rõ, nhưng tốn 1.000–4.000 token cho mỗi ảnh, và agent không thể edit lại spatial layout đó để bàn lại với bạn.

Một sơ đồ ASCII 20 dòng có thể chỉ tốn 50–500 token nhưng truyền đủ ý: ô nào nối với ô nào, mũi tên đi hướng nào. Quan trọng hơn, agent có thể đọc, sửa, và trả lại diagram đó như text bình thường — không cần multimodal, không cần upload image. Đây là cách diễn đạt "tiết kiệm token + giàu cấu trúc" đặc biệt fit với coding agent thế hệ 2026.

Technical facts

So sánh với các tool khác

Lưu ý: trên npm cũng có một package tên termdraw (của jclulow/node-termdraw) — đó là thư viện render TUI, không liên quan tool của Ben. Ben publish dưới scope @termdraw/* để tránh nhầm.

Use cases

• Prompt coding agent về kiến trúc hệ thống: vẽ 3-tier auth flow, paste vào Claude Code / Pi / Cursor — agent hiểu chính xác spatial intent.
• Mô tả PR / commit phức tạp: chèn diagram fenced-markdown vào PR description — diagram render được trên cả GitHub lẫn IDE.
• Wireframe TUI app: phác layout TUI trước khi code Ink/OpenTUI.
• Remote dev qua SSH: vẽ diagram trên server không có GUI.
• README và docs: text diagram render được mọi nơi markdown render được — không sợ broken image, không cần CDN.

Limitations & pricing

Miễn phí, MIT. Nhưng có một số ràng buộc thực tế:

• Bắt buộc Bun 1.3+ — chưa hỗ trợ Node thuần, hơi cấn cho ai chưa cài Bun.
• Cần terminal hỗ trợ mouse — không chạy trong basic tty, một số SSH client cũ hoặc cygwin có thể fail.
• Project mới ra (~41 sao, 5 PR mở khi launch) — kỳ vọng có breaking change trong vài tháng tới.
• Không có color fidelity — focus vào cấu trúc, không phải thẩm mỹ.
• Chưa có chế độ collab / multiplayer.

What's next

Roadmap chưa công bố chính thức. Quan sát monorepo + các project song song của Ben (opentui-island, ansi-to-img đều bump cùng tuần) thì hướng tiếp theo nhiều khả năng là: thêm package @termdraw/* cho Cursor / Claude Code skill, mở rộng shape library, và Pi extension API sâu hơn. Tổng thể, termDRAW khớp với theme của Modem ecosystem (hunk, baudbot, glance, slop-scan): công cụ review-first, agent-friendly cho dev đã sống trong terminal.

Nếu bạn đang prompt coding agent hằng ngày bằng cách mô tả "ô A nối ô B" hoặc dán screenshot Excalidraw nặng vài MB — thử npm install --global @termdraw/app 5 phút, có thể thay đổi cách bạn truyền design intent cho agent.

Nguồn: launch tweet của Ben Vinegar, benvinegar/termdraw, pi.dev.