Quickstart
3 つのコマンド。 サインアップ無し。
Open Design のエントリポイントは 1 つ：pnpm tools-dev。daemon が SQLite のプロジェクト DB と各プロジェクトの artifact 用に、隠しの .od/ フォルダを自動で作ります。od init ステップはありません。
前提
- · Node ~24 —
nvm install 24 && nvm use 24またはfnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - ·
PATHに少なくとも 1 つの対応 coding-agent CLI — Claude Code、Codex、Cursor、Gemini、OpenCode、Qwen、Copilot、Devin、Hermes、Kimi、Kiro、Vibe、Pi のいずれか（あるいは何も入れずに BYOK プロキシを使ってもよい）
3 つのコマンド
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webtools-dev が出力する Web URL を開きます。ウェルカムダイアログを開き、Anthropic Key を貼って（BYOK フォールバックを使うときだけ必要）、prompt を打って、送信。
初回起動の状態
daemon が管理する隠しフォルダは 1 つだけ。
.od/
├── app.sqlite ← projects · conversations · messages · open tabs
├── artifacts/ ← 単発の「ディスクに保存」レンダリング（タイムスタンプ付き）
└── projects/<id>/ ← 各プロジェクトの作業ディレクトリ、Agent の cwd でもある| やりたいこと… | やり方 |
|---|---|
| 中身を覗く | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| クリーンな状態にリセット | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| 別の場所に移動 | 未対応 — パスはリポジトリ相対でハードコードされています |
ライフサイクルコマンド
全部 pnpm tools-dev.
pnpm tools-dev start # daemon + web を起動（バックグラウンド）
pnpm tools-dev run web # 同等のフォアグラウンド実行
pnpm tools-dev stop # すべて停止
pnpm tools-dev status # 何が動いているか、どこで動いているか
pnpm tools-dev logs # daemon + web のログを追跡
pnpm tools-dev inspect # 動作中のプロセスへ IPC
pnpm tools-dev check # ヘルスチェックデスクトップ / バックグラウンド起動、固定ポート再起動、メディア生成のディスパッチ詳細（OD_BIN、OD_DAEMON_URL）は GitHub の QUICKSTART.md を参照。
プラットフォーム · v0.5.0
3 つのプラットフォーム、 3 つの状態。
v0.5.0 は各プラットフォームの現状を率直に伝えます。お使いのマシンに合う行を選んでください。
| プラットフォーム | 状態 | 備考 |
|---|---|---|
| macOS | 安定 | Apple Silicon (arm64) のみ — Intel ビルドはありません。macOS 11 Big Sur 以降。 |
| Windows | 安定 · 未署名 | x64、Windows 10 / 11。SmartScreen が初回起動時に警告 — More info → Run anyway を選んで進めます。 |
| Linux | headless のみ | v0.5.0 から CLI ライフサイクル（install / start / stop）が一級サポート。GUI パッケージは未提供 — サーバや CI に向きます。下記参照。 |
Linux · headless
DISPLAY のないサーバで Open Design を動かす。
v0.5.0 は非グラフィカルなライフサイクル経路を出荷します。headless な Linux マシン上に daemon と web を立て、ラップトップのブラウザから叩く。バックエンドは同じ、前面に Electron シェルが無いだけです。
pnpm install
pnpm tools-pack linux install --headless # 一回限りの初期化
pnpm tools-pack linux start --headless # daemon + web、Electron なし
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # headless ログを追跡Apt パッケージ、namespace 権限、FUSE 注意点はすべて tools/pack/README.md に。Ubuntu 24.04 と Arch Linux で検証済。0.5.0 PR #686 で投入。
セルフホスト · v0.5.0
あるいは 1 つのコンテナとして。
v0.5.0 は公式の Docker Compose デプロイ経路を提供します。Alpine ベースのイメージ 1 つ（docker.io/vanjayak/open-design）。daemon が API とビルド済み Next.js 静的エクスポートの両方を配信 — nginx も別フロントエンドコンテナも不要。
git clone https://github.com/nexu-io/open-design.git
cd open-design/deploy
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose pull
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose up -d --no-build
# → http://127.0.0.1:7456デフォルトは 127.0.0.1:7456 バインド、メモリ上限 384 MB、ランタイムボリュームは /app/.od にマウント。daemon を公開ネットワーク面にそのまま晒さない — 非ブラウザクライアントには API が無認証です。前段に認証付きのリバースプロキシ、SSH トンネル、または VPN を置きます。完全なドキュメントは deploy/README.md。イメージは設計上 Claude / Codex / Gemini CLI を同梱しません — それらはコンテナ外に置きます。
それで、次は？
何かをレンダリングしてみる。
daemon が起動したら、Skill（何を作るか）、Design System（どう見えるか）、そして「良いとはどういうものか」の参考を 1 つ用意します。