Deck IDE

複数のターミナルを並列で管理できる軽量な Web IDE。AIエージェント（Claude Code、Codex CLI 等）を永続的に動かすことに最適化されています。

特徴

• マルチターミナル — 複数のターミナルを同時に起動・管理。グリッドレイアウトで自動配置
• デッキシステム — ワークスペースごとにターミナルをグループ化。最大3デッキまで分割表示
• Monaco Editor — VS Code と同じエディタエンジンによるコード編集
• Git 統合 — ステージング、コミット、プッシュ、プル、ブランチ管理、Diff ビューア
• マルチリポジトリ対応 — ワークスペース内の複数 Git リポジトリを自動検出
• ファイルエクスプローラー — ファイル・フォルダの作成、削除、コンテキストメニュー
• ターミナルバッファ永続化 — WebSocket 切断・再接続時にターミナル出力を完全復元
• Basic 認証 — CLI またはブラウザ設定画面から認証の有効化が可能
• CLI ツール — deckide コマンドでバックグラウンド起動・停止・設定管理
• モバイル対応 — タッチ操作、スワイプでのデッキ切替、レスポンシブレイアウト

クイックスタート

npm からインストール（推奨）

npm install -g deckide
deckide

ブラウザが自動で http://localhost:8787 を開きます。

ソースから実行

git clone https://github.com/tako0614/ide.git
cd ide
npm install

# 開発モード（ホットリロード付き）
npm run dev:server   # ターミナル1: サーバー (port 8787)
npm run dev:web      # ターミナル2: Web (port 5173)

# または本番ビルド
npm run build
npm run serve

CLI リファレンス

deckide [start]                サーバー起動（バックグラウンド）
deckide start --fg             サーバー起動（フォアグラウンド）
deckide stop                   サーバー停止
deckide restart                サーバー再起動
deckide status                 サーバー状態表示
deckide logs [-f]              サーバーログ表示

deckide port                   現在のポート表示
deckide port <number>          ポート変更（自動再起動）

deckide auth on [user] [pass]  Basic 認証を有効化
deckide auth off               Basic 認証を無効化
deckide auth status            認証状態表示

deckide config                 全設定表示
deckide config set <key> <val> 設定値変更
deckide config get <key>       設定値取得
deckide config reset           設定リセット

起動オプション

| オプション | 説明 | |-----------|------| | -p, --port <port> | ポート番号（デフォルト: 8787） | | --host <host> | バインドアドレス（デフォルト: 0.0.0.0） | | --no-open | ブラウザを自動で開かない | | --fg | フォアグラウンドで起動 |

使い方

ワークスペース

1. サイドバーのフォルダアイコンをクリック
2. 「ワークスペース追加」でディレクトリパスを指定
3. ワークスペースを選択するとエディタ・ファイルツリー・Git 操作が利用可能

デッキとターミナル

1. ターミナルビューで「+」からデッキを作成
2. デッキ内で「+」「C」「X」ボタンからターミナルを追加
   • + — 通常のシェル
   • C — claude コマンド（Claude Code）
   • X — codex コマンド（Codex CLI）
3. 複数デッキをタブで切り替え。ドラッグ&ドロップで並び替え・分割表示

Git 操作

1. ワークスペースエディタ内のソース管理パネルを開く
2. 変更ファイルを確認し「+」でステージング
3. コミットメッセージを入力してコミット
4. プッシュ / プル / フェッチで同期

プロジェクト構成

ide/
├── bin/
│   └── deckide.js       # CLI エントリーポイント
├── src/                  # バックエンド (Node.js)
│   ├── index.ts          # サーバー起動
│   ├── server.ts         # Hono アプリ構築・ミドルウェア
│   ├── config.ts         # 環境変数・設定
│   ├── websocket.ts      # WebSocket サーバー・ターミナル接続
│   ├── types.ts          # 型定義
│   ├── routes/           # API ルート
│   │   ├── workspaces.ts
│   │   ├── decks.ts
│   │   ├── files.ts
│   │   ├── terminals.ts
│   │   ├── git.ts
│   │   └── settings.ts
│   ├── middleware/        # 認証・CORS・セキュリティ
│   ├── utils/            # DB・パス・UTF-8・シェル
│   └── shared/           # フロント/バック共有型・ユーティリティ
├── web/                  # フロントエンド (React)
│   └── src/
│       ├── App.tsx
│       ├── components/   # UI コンポーネント
│       ├── hooks/        # カスタムフック
│       ├── utils/        # ユーティリティ
│       └── styles.css    # Tailwind CSS + カスタムスタイル
├── data/                 # SQLite データベース
└── docs/                 # ドキュメント

技術スタック

| レイヤー | 技術 | |---------|------| | フロントエンド | React 18, Vite, Tailwind CSS 4, Monaco Editor, xterm.js 5 | | バックエンド | Hono, node-pty, simple-git, WebSocket (ws), Zod | | データベース | Node.js 組み込み SQLite (node:sqlite) | | 言語 | TypeScript | | ランタイム | Node.js >= 22.5.0 |

環境変数

| 変数名 | 説明 | デフォルト | |--------|------|-----------| | PORT | サーバーポート | 8787 | | HOST | バインドアドレス | 0.0.0.0 | | DEFAULT_ROOT | デフォルトルートパス | ホームディレクトリ | | BASIC_AUTH_USER | Basic 認証ユーザー名 | — | | BASIC_AUTH_PASSWORD | Basic 認証パスワード（本番は12文字以上） | — | | CORS_ORIGIN | CORS 許可オリジン（本番は必須） | — | | NODE_ENV | 実行環境 | development | | MAX_FILE_SIZE | 最大ファイルサイズ (bytes) | 10485760 (10MB) | | TERMINAL_BUFFER_LIMIT | ターミナルバッファ上限 (bytes) | 500000 | | TRUST_PROXY | プロキシヘッダーを信頼 | false | | DECKIDE_DATA_DIR | データディレクトリ | ~/.deckide |

API

ワークスペース

| メソッド | パス | 説明 | |---------|------|------| | GET | /api/workspaces | 一覧 | | POST | /api/workspaces | 作成 | | DELETE | /api/workspaces/:id | 削除 | | GET | /api/config | デフォルト設定取得 |

デッキ

| メソッド | パス | 説明 | |---------|------|------| | GET | /api/decks | 一覧 | | POST | /api/decks | 作成 | | PUT | /api/decks/order | 並び替え | | DELETE | /api/decks/:id | 削除 |

ファイル

| メソッド | パス | 説明 | |---------|------|------| | GET | /api/files | ディレクトリ一覧 | | GET | /api/preview | ディレクトリプレビュー | | GET | /api/file | ファイル読み込み | | PUT | /api/file | ファイル保存 | | POST | /api/file | ファイル作成 | | DELETE | /api/file | ファイル削除 | | POST | /api/dir | ディレクトリ作成 | | DELETE | /api/dir | ディレクトリ削除 |

ターミナル

| メソッド | パス | 説明 | |---------|------|------| | GET | /api/terminals | 一覧 | | POST | /api/terminals | 作成 | | DELETE | /api/terminals/:id | 削除 | | WS | /api/terminals/:id | WebSocket 接続 |

Git

| メソッド | パス | 説明 | |---------|------|------| | GET | /api/git/status | ステータス | | GET | /api/git/repos | リポジトリ一覧 | | GET | /api/git/multi-status | 複数リポジトリの集約ステータス | | POST | /api/git/stage | ステージング | | POST | /api/git/unstage | アンステージ | | POST | /api/git/commit | コミット | | POST | /api/git/discard | 変更を破棄 | | GET | /api/git/diff | 差分取得 | | POST | /api/git/push | プッシュ | | POST | /api/git/pull | プル | | POST | /api/git/fetch | フェッチ | | GET | /api/git/remotes | リモート一覧 | | GET | /api/git/branch-status | ブランチ状態（ahead/behind） | | GET | /api/git/branches | ブランチ一覧 | | POST | /api/git/checkout | ブランチ切り替え | | POST | /api/git/create-branch | ブランチ作成 | | GET | /api/git/log | コミット履歴 |

その他

| メソッド | パス | 説明 | |---------|------|------| | GET | /health | ヘルスチェック | | GET | /api/settings | 設定取得 | | POST | /api/settings | 設定更新 | | GET | /api/ws-token | WebSocket 認証トークン | | POST | /api/shutdown | サーバー停止 |

WebSocket プロトコル

ターミナル接続は /api/terminals/:id WebSocket エンドポイントを使用します。

クライアント → サーバー:

• { type: "claim" } — リサイズ権限を取得
• { type: "resize", cols, rows } — PTY サイズ変更
• バイナリフレーム — キーボード入力

サーバー → クライアント:

• { type: "sync", offsetBase, reset } — バッファ同期開始
• { type: "ready" } — 同期完了、入力受付可能
• バイナリフレーム — ターミナル出力

再接続時はバッファオフセットを指定して差分のみ取得可能（?bufferOffset=N&reconnect=1）。

ライセンス

MIT

作者

tako0614