HN 日本語サマリー

← 一覧へ戻る
Web開発

Drawgent: ライブExcalidrawキャンバス上のコーディングエージェント

Drawgent: Coding agent on a live Excalidraw canvas (tangled.org)

177 pointsby parasitid46 コメント

要約

Drawgentは、Claude Code、Codex、またはopencodeといったユーザー自身のコーディングエージェントを、ライブのExcalidrawホワイトボードに接続するツールです。チャットパネルで図を要求したり、描画の一部を指してAGENT: ...と記述したりすることで、エージェントはキャンバス(シーンとスクリーンショット)を参照し、ライブで編集してレイアウトを確認します。各ボックスは対応するコードとリンクされており、描画に合わせてコードを変更することも可能です。Drawgentは単一のバイナリとして提供され、エディタの提供、ボードの管理、スクリーンショットのレンダリングを行います。

全文翻訳

Rust 63.8%

JavaScript 31.9%

CSS 2.4%

Shell 0.8%

Makefile 0.6%

HTML 0.2%

Nix 0.2%

Dockerfile 0.2%

50 1 1

このリポジトリをクローンする

パーマリンクを使用する

HTTPS

https://tangled.org/yanndegat.tngl.sh/drawgent https://tangled.org/did:plc:3zklierfkckthy6sodbm4af3

SSH

git@tangled.org:yanndegat.tngl.sh/drawgent git@tangled.org:did:plc:3zklierfkckthy6sodbm4af3

セルフホスト型のノットの場合、クローンURLはセットアップによって異なる場合があります。

tar.gzをダウンロード .zipをダウンロード

README.md

drawgent: ライブExcalidrawキャンバス上のコーディングエージェント#

drawgentは、あなた自身の Claude Code、Codex、またはopencode(あなたのインストール、ログイン、設定、リポジトリ)をExcalidrawホワイトボードに接続します。チャットパネルで図をリクエストしたり、描画の一部に隣接して AGENT: … と書き込んだり、レーザーポインターで指し示したりできます。

エージェントはキャンバス(シーンとスクリーンショット)を確認し、ライブで編集してレイアウトをチェックします。コードに対応する各ボックスをリンクしたままにし、描画内容に合わせてコードを変更できます。

[画像: エージェントが自身のコードからdrawgent自身のアーキテクチャを描画している様子(3倍速)]

仕組み#

[画像: drawgentのアーキテクチャ:ブラウザ、drawgentサーバー、コーディングエージェント、およびそのMCPキャンバスツール]

  • サーバー: drawgentは単一のバイナリです。エディタを提供し、ボードを管理し、ヘッドレスChromeを実行してスクリーンショットをレンダリングします。
  • エージェント: drawgentはエージェントを起動するか、既に実行中のセッションに接続し、MCP経由でキャンバスツールを提供します。
  • ルーム: 共有のexcalidraw.comルームまたはセルフホスト型のExcalidrawドキュメント内で、drawgentはもう一人の共同作業者となります。

インストール#

drawgentは単一の静的バイナリです。お使いのプラットフォーム向けの最新リリース0.2.1をダウンロードしてください:

またはターミナルから(テーブルのプラットフォーム名をお使いの名前に設定してください t):

v=0.2.1 t=x86_64-unknown-linux-musl     # または aarch64-unknown-linux-musl, aarch64-apple-darwin, x86_64-apple-darwin
base=https://tangled.org/yanndegat.tngl.sh/drawgent/tags/v$v/download
curl -fLO $base/drawgent-$v-$t.tar.gz -fLO $base/drawgent-$v-$t.tar.gz.sha256
sha256sum -c drawgent-$v-$t.tar.gz.sha256                  # macOS: shasum -a 256 -c …
tar xzf drawgent-$v-$t.tar.gz && install drawgent-$v-$t/drawgent ~/.local/bin/
  • macOS: バイナリは署名されていません。一度 xattr -d com.apple.quarantine ~/.local/bin/drawgent を実行してください。
  • その他のバージョン: 各リリースはタグページにあります。
  • ソースから: 開発を参照してください。

クイックスタート#

インストールされログイン済みのエージェント(claude、codex、またはopencode)が1つ必要です。それ以外は不要です。Node.jsやDockerも不要です。

drawgent setup claude        # エージェントごとに一度実行:CLI、ログイン、ブリッジ、レンダラーをチェックします
cd ~/my-repo
drawgent up                  # このリポジトリで新しいエージェントセッションを開始し、ブラウザでキャンバスを開きます
drawgent up --attach         # または、既に実行中のセッションにキャンバスを接続します

その後、次のように尋ねてください:「このリポジトリのアーキテクチャを、ロールごとにグループ化し、各ボックスをコードにリンクして描画してください。」完全なウォークスルー(インストールとトラブルシューティングを含む)は、スタートガイドにあります。

機能#

図がある場所でエージェントと対話する#
  • チャットパネル: 返信やツール呼び出しがストリーミングされ、権限プロンプトはボタンとして表示され、停止でターンをキャンセルできます。各ターンの下に、使用したトークン、コンテキストの使用量、コストが表示されます。
  • AGENT:ノート: キャンバスに書かれたノートは、入力を停止するとトリガーされ、それが指しているものを表します。エージェントは緑色のDONE:ノートで応答します。
  • 元に戻す: エージェントの編集は元に戻すスタックに記録されます。Ctrl+Zで元に戻し、↶ 元に戻すでターン全体を元に戻します。

→ キャンバス

レーザーで指し示し、タスクを選択する#

Excalidrawのレーザー(K)を使って、図の一部を円で囲んだり、取り消し線を引いたり、接続したり、離したりできます。drawgentはジェスチャーとその対象を認識します。2秒後、投票で手作業では面倒なタスクが2〜3個提示され、その他…も選択できます:

  • コードからコンポーネントをドリルダウンする
  • コード内でA → B をトレースする
  • アーキテクチャから削除し、コードへの影響を示す
  • スペースを作り、再配置する

ボックスを取り消し線で消すことも、エージェントに削除が何に影響するかを伝えます。

[画像: コードにリンクされたボックスを円で囲んだ後の投票]

→ レーザーとジェスチャー

コードにリンクされた図#
  • コードリンク: 各ボックスはファイル、行、シンボルを指し示し、コードタブで開くことができます。リンクは✅ OK、↕移動済み、⚠古い、❌見つからないとしてチェックされ、drawgent checkはリンクが壊れた場合にCIで失敗します。
  • リポジトリマップ: 🗺 リポジトリをマップは、ワークスペースをトレマップとして描画し、各ファイルにリンクします。
  • コードを指し示す: パスを入力する代わりに、フォルダ、ファイル、行を指し示します。
  • 🔨 描いたものをビルド: 図を変更すると、エージェントが変更を実装し、キャンバスに進捗をマークします。

→ コードと図

ボード、およびリポジトリ内の図#
  • ボード: ワークスペースごとに好きなだけボードを作成できます。ボード間で図を移動またはコピーしたり、フレームごとに分割したりできます。
  • リポジトリ内: --diagram docs/architecture.excalidraw は、クリーンで差分可能な.excalidrawファイルにボードを保存し、git pullに従います。

→ キャンバス

あなたのエージェント、あなたのやり方で#
  • エージェント: Claude CodeとCodexはdrawgentに組み込まれたブリッジ経由で、opencodeはネイティブに接続します。
  • セッション: 新規セッション、または実行中のセッションに--attachします。Claudeセッションはフォークされ、opencodeとCodexセッションはライブで参加します。
  • 権限: --permissions canvas|ask|all。

→ エージェント

共有ドキュメントとブラウザ拡張機能#
  • ルーム: excalidraw.comのルーム、またはセルフホスト型Excalidrawのドキュメント(SSOの有無にかかわらず)に共同作業者として参加します(drawgent remote add)。
  • Firefox拡張機能: 開いているドキュメントの隣にdrawgentサイドバーが表示されます。ワンクリックで参加でき、レーザーのストロークがジェスチャーに変換されます。

→ 共有ルーム · ブラウザ拡張機能

作業場所で実行#
  • バックグラウンド: drawgent up -d、その後statusとdown。
  • キャンバスのみ: コードベースのない図用の--no-workspace。
  • リモートマシン: ヘッドレスマシン上のssh -Lヒント、公開されているものには--token。

→ drawgentの実行

ドキュメント#

ページ内容
スタートガイドインストール、setup、最初の図、トラブルシューティング
ユースケースウォークスルー:コードベースの理解、機能の設計と実装、PRアーキテクチャのレビュー、アーキテクチャドキュメントの維持、コードなしのホワイトボード、チームメイトのドキュメントでの作業
キャンバスチャットパネル、AGENT:ノート、元に戻す、複数のボード、リポジトリ内の.excalidrawファイル
レーザーとジェスチャーレーザーゾーン、すべてのジェスチャーと提示されるタスク、取り消し線、スペースの確保
コードと図コードリンク、コードタブ、リポジトリマップ、コードの指し示し、描いたものをビルド、drawgent check
エージェントClaude Code、Codex、opencode:セットアップ、ブリッジ、--attach、権限、その他のACPエージェント
共有ルームexcalidraw.com、セルフホスト型サーバー、remote add、トークン、設定、制限
ブラウザ拡張機能Firefoxサイドバーのインストールと使用方法、仕組み
drawgentの実行バックグラウンドモード、キャンバスのみ、リモートマシン、トークン、ファイルの場所、Docker
リファレンスすべてのコマンドとオプション、設定ファイル、環境変数、MCPツール、REST API
開発ビルド、コードレイアウト、テスト、CIとリリース、拡張機能、画像の再生成

コマンド#

コマンド
`drawgent setup <claudecodex
drawgent up [--attach] [-d] [--room LINK] [--diagram FILE] [--no-workspace]エージェントと共にキャンバスを起動する
drawgent status / drawgent down実行中のdrawgentの状態表示/停止
drawgent remote add LINK / drawgent remote listセルフホスト型Excalidrawサーバーの追加/一覧表示
drawgent check [--fix]図のコードリンクをチェックする(CI用)
drawgent serve, drawgent mcp明示的なエージェントを持つ低レベルサーバー;MCPサーバーがエージェントを起動する
drawgent licensesライセンスとサードパーティの通知を表示する

すべてのオプションはリファレンスに記載されています。

制限事項#

  • Chrome: レンダラーにはChromeまたはChromiumが必要です。setupがそれらを見つけるかインストールします。
  • Claude --attach: Claude Codeには実行中のターミナルセッションにメッセージを挿入する公開された方法がないため、これはフォークとして実装されています。
  • Codex --attach: ログイン済みのCodexに対してライブアタッチはまだテストされていません。
  • ルーム: ルームは1つのボードをミラーリングし、画像は同期されません。セルフホスト型サーバーでは、ブラウザでドキュメントが開かれている必要があります(保存されます)。共有ルーム › 制限事項を参照してください。
  • macOS: ビルドはクロスコンパイルされており、署名されていません。また、実際のMacではまだテストされていません。

ライセンス#

drawgentはフリーソフトウェアです:GPL-3.0-or-later、保証はありません。drawgent licensesで通知が表示されます。

バイナリは、GPL互換ライセンス(MIT、Apache-2.0、BSD、ISC、フォント用のOFLなど)の下でサードパーティの作業をバンドルしています。完全なテキストはTHIRD_PARTY_LICENSES.mdにあります。

コーディングエージェントとChromeはdrawgentの一部ではありません。これらはあなた自身のインストールから、独自の条件で実行されます。