Drawgent: ライブExcalidrawキャンバス上のコーディングエージェント
Drawgent: Coding agent on a live Excalidraw canvas (tangled.org)
要約
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%
このリポジトリをクローンする
パーマリンクを使用する
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はセットアップによって異なる場合があります。
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をダウンロードしてください:
| プラットフォーム | ダウンロード | チェックサム |
|---|---|---|
| Linux x86_64 | drawgent-0.2.1-x86_64-unknown-linux-musl.tar.gz | sha256 |
| Linux arm64 | drawgent-0.2.1-aarch64-unknown-linux-musl.tar.gz | sha256 |
| macOS Apple Silicon | drawgent-0.2.1-aarch64-apple-darwin.tar.gz | sha256 |
| macOS Intel | drawgent-0.2.1-x86_64-apple-darwin.tar.gz | sha256 |
またはターミナルから(テーブルのプラットフォーム名をお使いの名前に設定してください 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。
ドキュメント#
| ページ | 内容 |
|---|---|
| スタートガイド | インストール、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 <claude | codex |
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の一部ではありません。これらはあなた自身のインストールから、独自の条件で実行されます。