Project Hub
この文書は、Project Hub の機能と成り立ちを百科事典の記事の形でまとめた紹介文です。Wikipedia へ投稿したものではありません。内容はリポジトリ内の説明書と変更の記録(ソース版 4.126.98、2026年11月15日時点)に基づきます。配布版の番号などは、この時点の手元の資料に書かれていた情報で、最新の状態を保証するものではありません。
Project Hub(プロジェクト・ハブ)は、複数のプロジェクトと作業を一覧で管理し、その画面の中で Claude Code や Codex などの AI コーディング用コマンドラインツール(CLI)を動かすための、ローカル実行型の管理ソフトウェアである。1人の利用者が自分の Mac または Windows 11 x64 の上で使うことを前提とし、Node.js で動く本体がそのパソコンの中(127.0.0.1)だけで待ち受ける。AI に作業を任せながら、成果の取り込みや公開の判断は人が行う、という分担を画面と記録の仕組みで支える点に特徴がある。MIT ライセンスで公開されている。
| 基本情報 | |
|---|---|
| 種別 | プロジェクト・作業管理ソフト、AI CLI の操作環境 |
| 対応 OS | macOS 13 以降(Apple Silicon)、Windows 11 x64 |
| 動作環境 | Node.js 22 以上、Git、利用する AI の CLI |
| 主な実装 | Node.js(本体)、node-pty(画面内の端末)、xterm.js(端末表示)、Swift と WebKit(Mac の専用窓)、WebView2(Windows の専用窓) |
| 対応 AI | Claude Code、Codex、Agy CLI(Gemini)、Grok Build、ChatGPT(外部ソフト経由・任意) |
| 表示言語 | 日本語(内蔵)、繁體中文・英語(言語パック) |
| ソース版 | 4.126.98(2026年11月15日、手元の資料による) |
| 公開配布版 | 4.126.98(Mac・Windows、2026年11月15日時点の公開リリースによる) |
| ライセンス | MIT |
| リポジトリ | https://github.com/kieiken/project-hub |
概要
Project Hub は、利用者が抱える複数のプロジェクトを「台帳」と呼ぶフォルダ群で管理する。各プロジェクトには PROJECT.md という説明ファイルがあり、その下の作業ごとに作業ファイルと会話の記録が保存される。利用者は画面左のツリーからプロジェクトと作業を選び、作業の会話画面で依頼を書くと、選んだ AI とモデルがその作業を受け持つ。
AI はプロジェクト本体ではなく、作業ごとに作られる Git の作業用コピーで作業する。その成果を本体へ取り込むかどうかは、人が[本体に取り込む]や[統合…]などの操作で決める。公開・投稿・送信のように作業の内容を外部へ出す操作も、人がそのつど承認する前提になっている。
Web サービスや共有サーバーとして使うことは想定されていない。利用者の認証機能はなく、AI の料金は各 CLI のプランと設定に従う。
基本となる考え方
プロジェクト・作業・フェーズ
- プロジェクト:まとまった目的の単位。台帳フォルダと
PROJECT.mdで表され、説明・フェーズ・問題点・関連プロジェクト・本体のフォルダの場所を持つ。親プロジェクトを指定して入れ子にもできる。 - 作業:プロジェクトの中の個々の仕事。作業ファイルに「手順」「やったこと」「次にやること」「成果」などの節があり、AI と人が区切りごとに書き足す。手順の済み数から進み具合の棒が表示され、すべて済むと完了の確認に進む。
- フェーズ:プロジェクトの道のり(例:設計 → 第1版 → 使ってみる)。概要画面の上に並び、今のフェーズの作業がすべて終わると、COMPLETE の表示と[次のフェーズへ進む]が出る。作業の一覧は今のフェーズの分だけを表示し、ほかは畳まれる。
- 子作業・子プロジェクト:[子プロジェクトに分ける]で作業を分けて同時に進められる。分岐した作業は左のツリーで一段下に「↳」付きで表示され、「⑂2」のように分岐の数が出る。
- フリートーク:特定のプロジェクトに属さない自由な会話。一覧の最上部に常設され、話題ごとに会話が分けられる。
状態の表示
左のツリーの丸の色で状態を表す。灰はまだ始めていない、赤は AI が作業中、薄緑は処理が終わった、紫は完了(人が[プロジェクトを完了にする]を押した時だけ)、黄は人の返事が必要であることを示す。一覧には「未読」「返事待ち」「完了確認」が文字でも表示され、画面上部の「あなたの番」に返事待ちと完了確認の件数が別々に出る。AI の画面が 20 秒止まると「入力待ち」と表示される。
依頼から取り込みまでの流れ
標準的な流れは次のとおりである。
- 始める:プロジェクト画面でやりたいことを書いて[始める]を押すと、作業ができ、会話画面で AI に送られる。担当 AI・モデル・思考の深さを選べ、プロジェクトごとに前回の担当を覚える(初回は Claude Code)。
- 作業用コピーの作成:Git のあるプロジェクトでは、作業ごとに作業用コピー(Git の worktree、
Work/<プロジェクト>/<作業ID>/)が自動で作られ、AI はそこで作業する。Git の無いプロジェクトでは、始める前に毎回保存してから本体で作業する。 - 会話と進行:AI は作業ファイルの手順を更新しながら進める。判断が必要な時は選択肢のボタン付きで質問し、作業は返事待ち(黄)になる。
- 完了の確認:手順がすべて済むと「完了確認」になり、人が[完了に移す]か[まだ続ける]を選ぶ。
- 成果の記録:作業ファイルの「成果」に、ファイル・本体保存済み(リポジトリとコミット)・なし(理由)のいずれかを書く。記録が整っていない時は、AI が所属や重複を調べて記録を整え、人にファイル名で選ばせない。
- 取り込み:通常の作業は[本体に取り込む]で作業用コピーを本体に取り込み、作業用コピーはゴミ箱へ移る。取り込む前には変更の量(ファイル数・行数)と「本体とぶつかりそう」かが表示され、ぶつかった時は取り込まずに「あなたの番」に出る。変更が 0 件の時は取り込みのボタンを表示しない。
- 子作業の統合:子作業の成果は親の[統合…]から受け取る。子ごとに[残す/残さない]を選び、[統合][選別統合(件数)][一括統合]で取り込む。未完了の子でも[成果を渡す(途中)]で保存済みの成果を先に渡せ、途中の受け取りでは子の会話・作業用コピー・残りの手順が保持される。片付けは完了した子の最終統合の時だけ行われる。
本体へ取り込まない作業は[取り込み対象から外す]で取り込みボタンを隠せ、あとで[取り込み対象に戻す]で戻せる。
会話画面と作業画面
会話画面
通常使う画面。1 本の会話の中で、送るたびに答える AI・モデル・思考の深さを選べ、返事には誰が答えたかの印が付く。AI を替えると、新しい AI がまだ見ていない会話(人と AI の文字だけ)を引き継ぎとして渡す。同じ AI が続ける場合は、その AI 自身の会話を再開する。
AI が作業している間に書いた指示は、次の 3 つから扱いを選べる。
- 取り消してやり直す:今の作業を止めて、新しい指示でやり直す。
- 追加説明(一緒にやる):今の作業に説明を足す。
- 終わったら次に:順番待ちに並べ、終わると順に自動で始まる。並べた指示は保存され、再起動しても残る。
待っている指示は[台帳へ退避]でアイデア台帳に記録だけ残して列から外すこともできる。会話の中のコード枠には[⧉ コピー]があり、人が他の AI へ送る文をそのままコピーできる。表は Markdown の表として表示される。
話し合い
会話画面の[話し合い]では、2〜4 組の AI・モデルが独立して意見を出し、1〜2 回の意見交換を経て、まとめ役がまとめる。最初の意見には他の参加者の答えを渡さない。各回は新しい読み取り専用のセッションで動き、発言は名前付きで同じ作業に保存される。参加者が利用上限になった場合はモデルを替えずに不参加とし、残りで続ける。初版で参加できるのは Claude Code と Codex である。
作業画面
画面いっぱいに AI の端末を開く画面。[Claude Code で始める][Codex で始める]で起動し、[+ 並べる]で左右に並べて同時に作業できる。見出しのモデル・思考を変えると、動いている AI に /model・/effort を送って切り替える。[○○に交代 →]を押すと、前の AI の会話を .ai/handoff/ の引き継ぎ資料にまとめ、相手の AI に読ませて続けさせる。ファイルや画面写しを端末に落とすと AI-Workspace/Inbox/hub/<日付>/ に保存され、その AI の入力欄に場所が入る。窓を閉じても本体と AI は裏で動き続ける。
役割分担・委任・利用上限
役割分担
司令塔・調査・デザイン・画像生成・コーディング・チェック・文章などの役割ごとに、担当の AI・モデル・思考を設定する。説明書に記された初期設定では、司令塔とチェックが Fable 5.2、調査・デザイン・文章が Opus 5.5、画像生成とコーディングが GPT-6.1-Sol である。役割ごとに仕事の難しさで担当を分ける設定もあるが、人が有効にするまでは従来の担当を使う。役割分担は[見直し]で別の AI に相談することもできる。
モデルの選択肢には、ログイン済みの CLI が「今使える」と答えたものだけが出る。CLI の版とモデル一覧は Hub の起動中に毎日確認され、[一括更新]で手動でも更新できる。新しいモデルが見つかっても、使っている担当は自動では変わらない。
AI から AI への委任
AI は Hub の決められた窓口(/api/delegate)を通して、同じ作業の会話の中で別の AI へ仕事を渡す。子作業は増えず、動いている AI がいる時は終わった後の順番待ちに入る。待ち順・実行中の AI とモデル・結果は画面で確認できる。
利用上限の自動切替
上限の自動切替が有効な時、AI が利用上限に達したことを CLI の正式な表示で検知すると、その CLI の再試行を止め、終了を確かめてから、設定の「main/backup」に保存した代わりの担当へ同じ作業を引き継ぐ。初期設定では Fable 5.2 から Astra、Opus 5.5 から Sol 6.1 へ交代する。上限の状態は期限か手動の解除まで保たれ、両方が上限の時は待つ。会話の本文や引用に「上限」と書かれているだけでは交代しない。
このほか、設定[AI]の特殊モードを有効にすると、選んだ 1 つの AI に作業を集中させられる。この時は上限になっても別の AI へは交代せず、解除まで待つ。
AI アカウントと利用状況
Claude Code・Codex・Grok は、設定の「AI アカウント」で名前を付けて複数のアカウントを追加できる。追加したアカウントの設定は書類フォルダの外に分けて置かれ、作業と AI の組み合わせごとにアカウントを選べる。Hub にパスワードやトークンは入力せず、ログインは本人がターミナルで行う。Codex と Claude については、選んだアカウントの契約利用枠の割合を CLI から取得して表示する。また、このパソコンでの Token 利用量を集計し、内訳と消耗を監視できる(数値だけを読み、会話の本文や認証情報は保存しない。自動停止や外部への通知はしない)。
検索・記録・アイデア
会話の検索
左側の検索欄に言葉を入れると、すべてのプロジェクト・子プロジェクト・完了した作業・フリートークの人と AI の発言から候補が出る。既定の[簡易検索(現在のみ)]は今の会話だけを調べ、[詳細検索(過去も含む)]では正式に保管した過去の会話まで調べる。検索は部分一致で、全角・半角や英字の大文字・小文字を揃えて探すが、意味や同義語を推測する検索ではない。検索はこのパソコンの中だけで行い、外部への送信や AI への問い合わせはしない。候補は 50 件ずつ、最大 1,000 件まで表示される。
要約して続ける
長くなった会話は[要約して続ける]で、一回の操作で要約・原文の保管・会話の切り替えまで進む。整理結果の先頭には「次にする作業」が表示され、元の会話は[過去の会話]から読める。
操作の記録
始めた・止めた・渡した・取り込んだなどの操作は _hub/log.jsonl に記録され、設定画面の「最近の操作」で確認できる。
アイデア台帳
プロジェクトごとに 1 つのアイデア台帳を持ち、思いついた文章や画像を保存できる。保存の扱いは「記録だけ」(初期値)と「作る予定に入れる」の 2 つで、後者で保存した項目だけが制作の対象になる。会話の[台帳に残す]で、発言の原文を 1 回で残すこともできる。画像は PNG・JPEG・GIF・WebP に対応し、1 枚 20MB、1 回 10 枚までである。作る許可のある項目を自動で進める機能もあるが、初期は無効で、人が既存の作業用コピーと確認の方法を設定してから開始する。
削除と復元
右クリックの[削除…]では、ゴミ箱へ移すものと、共有のため残すものを確認してから削除する。AI・順番待ち・子作業・作業用コピーがある場合は移せない。[整理と確認]の記録から元に戻せる。
添付・閲覧・音声入力
- 画像の添付:会話欄へ画像をドラッグまたは貼り付けると、依頼の上に小さく表示される。画像だけでも送れ、送信に失敗しても添付は保持される。
- 動画の添付:MP4・MOV・M4V・WebM を 1 件 50MB・10 分まで追加できる。手元の ffmpeg で 4〜16 枚の時刻付き画像を取り出し、任意の専用環境を入れると音声も時刻付きの文字にできる。認識は手元で行い、外部へは送らない。
- 閲覧画面:画像・PDF・テキスト・Word などを会話の上の閲覧画面で表示し、[閉じる]や Esc で会話へ戻れる。
- 場所と URL:会話の中の 📁 付きの場所を押すと、フォルダは画面の中に中身の一覧、ファイルは対応するアプリで開く。URL はブラウザで開く。
- 音声入力:会話とアイデアの入力欄の[音声入力]で日本語を文字にできる。結果は入力欄に追加されるだけで、送信は人が行う。音声はブラウザの提供元などのサービスで処理される場合があり、環境によっては使えない。
設定と付加機能
- 表示言語:設定の「基本」→「言語」で選ぶ。日本語は本体に内蔵され、繁體中文と英語の言語パックが同梱されている。切り替えても、利用者の文章・パス・保存済みの状態や役割は変わらない。
- 自動更新:既定はオフ。Git で取得したソース、更新先のアプリ、ディスク確認の設定がそろった Mac でだけ使え、上流の確認は 24 時間に 1 回までに制限される。AI や順番待ちが残っている間は適用を待つ。
- Storage Guard:利用者が用意したディスク確認プログラムを指定すると、起動・セットアップ・アプリ作成・更新の前に確認し、失敗したら止める。未設定なら従来どおり動く。
- 外から使う(iPhone):設定で有効にして合言葉を決め、Tailscale を通して iPhone から接続できる。処理は接続先の Mac で行われる。
- ChatGPT(Chat/Pro):別途導入した外部ソフトを設定すると、Hub から自動で送り、返事を同じ会話に保存する。初期は無効で、ファイルの変更やコマンドの実行はしない。
- Agy CLI・Grok Build:CLI を導入してログインすると、会話や端末で選べるようになる。Hub は導入のコマンドを表示・コピーするだけで、自分では実行しない。
- GitHub への接続:[既存のGitHubに接続]で、ログイン済みアカウントの非公開リポジトリを選んで送り先として登録できる。登録と表示だけで、内容や履歴の同期はしない。
- MetaMuse 連携:Mac 専用。導入済みの固定版ツールを使い、本人が承認した質問と資料だけを送る。
仕組み
本体は server.js を中心とした Node.js のプログラムで、127.0.0.1:4545 だけで待ち受け、他のサイトからの操作を受け付けない。画面はブラウザ技術で作られており、Mac では Swift で書かれた専用アプリが本体を起動して WebKit で表示する。Windows ではブラウザで開く方法と、WebView2 を使う専用窓がある。主な部品は次のとおりである。
| 部品 | 役目 |
|---|---|
lib/store.js・lib/frontmatter.js | 台帳と作業ファイルの読み書き |
lib/launch.js | AI の起動コマンドの組み立て(画面のモデル名を CLI の引数に変換) |
lib/sessions.js | 画面の中の端末(node-pty) |
lib/roles.js | 役割分担の読み書き |
lib/git.js | 作業用コピーの作成・取り込み・片付け |
public/ | 画面(xterm.js を同梱) |
データはすべて手元のフォルダに置かれる。標準の置き場所は書類フォルダの下の AI-Workspace/ で、次のように分かれる。
| 場所 | 中身 |
|---|---|
_hub/ | 役割分担(roles.yaml)、操作の記録、言語・アカウント・更新などの設定 |
Product/<プロジェクト>/ | 台帳(PROJECT.md、作業ファイル、.ai/chat/ の会話、.ai/handoff/ の引き継ぎ資料) |
Work/<プロジェクト>/<作業ID>/ | 作業ごとの作業用コピー |
Inbox/hub/ | 端末に渡したファイル |
版の管理では、package.json の版と CHANGELOG.md の先頭の番号をそろえる決まりがあり、違うとテストが失敗する。機能を足した時は 2 つ目、直しただけの時は 3 つ目の数字を上げる。
導入と動作条件
Mac では、取得したフォルダの一番上で bash hub/setup.sh を実行する。これにより AI-Workspace/ の下に _hub/・Product/・Work/ が作られ(場所は HUB_ROOT で変更可)、架空のサンプル台帳が写され、デスクトップに Project Hub.app ができる。何度実行しても、すでにある役割分担と台帳は変更されない。アプリをダブルクリックすると専用の窓で開き、ターミナルは不要である。
Windows 11 x64 では hub/start-window.cmd で専用窓、hub/start.cmd でブラウザ版を開く。普通の権限で使い、管理者としては起動しない。MetaMuse 連携など Mac だけの機能もある。
どちらも Node.js 22 以上、Git、利用する AI の CLI(導入とログインが済んだもの)が必要である。テストは HUB_SKIP_NPM=1 npm --prefix hub test で実行する。
安全性と制約
説明書では、使う前に知っておくべき点として次が挙げられている。
- 既定では、Claude Code は許可確認を省き、Codex は許可確認とサンドボックスを省いて起動する。AI は利用者の権限でファイルを書き換えたりコマンドを動かしたりできる。起動のしかたは
_hub/roles.yamlのpermissionsで変えられる。 - 作業用コピーを作る時、Git に入っていない手元の設定ファイル(
.envなど)も写す。自動の Git 保存では新しく加わる秘密ファイルの代表的な名前を除外するが、秘密が入らないことは保証しない。 - 自動の Git 保存はフック(pre-commit など)を動かさずにコミットする。
- 会話・引き継ぎ資料・操作の記録は暗号化されずに手元に残る。
- Windows 版の隔離実行は Mac より制限が弱く、作業フォルダの外を読める場合がある。
- Mac のアプリは自己署名で、Apple の公証は受けていない。Windows 版にも発行者の署名がない。
- 実アカウントでの複数アカウントの同時動作、Grok の実際の導入と実行、Windows 実機での一部の流れなど、説明書に「未検証」「未実施」と書かれている機能がある。
沿革
変更の記録に残っている範囲での主な出来事は次のとおり。日付は記録上の日付である。
- 2026年9月26日:1.0.0。プロジェクトと作業の一覧、Claude Code・Codex の起動を備えた最初の版。同じ日のうちに、画面内の作業画面(2.0.0)、左のツリーと Claude Code・Codex の並列表示(3.0.0)、作業ごとの作業用コピー(3.2.0)、1 本の会話で AI を選べる会話画面(4.0.0)が加わった。
- 2026年10月2日:4.20.0。リポジトリのルートの説明を Project Hub のものに書き換えた。公開版の変更の記録はこの版から始まる。
- 2026年10月8日:4.88.0 で自動更新(既定オフ)と Storage Guard、4.89.0 で繁體中文の表示に対応。
- 2026年10月10日:4.100.0 で画像・PDF・文書の閲覧画面を追加。
- 2026年10月15日:4.115.0 で話し合い、4.117.0 でアイデア帳(のちのアイデア台帳)を追加。
- 2026年10月18日:4.124.2 で Windows 向けの通常権限での保存と WebView2 の専用窓を追加。
- 2026年10月24日:4.126.0 で Mac 専用の MetaMuse 連携を追加。
- 2026年11月8日〜15日:4.126.96〜4.126.98 で Token 利用の集計と監視、役割ごとの難しさによる担当の振り分けを追加。
リポジトリはもともと Discord Bot のテンプレート「discordpy-startup」(MIT)から作り始められた。Bot の部分は公開物に含まれていないが、由来として著作権表示と許諾文が残されている。設計にあたっては、teddashh/bat-agent-connector(入力待ちの見張り、取り込み前の確認、操作の記録)と arumwu/goose-acp-handoff(AI を交代する時の引き継ぎ資料)の考え方を参考にしたとされる。いずれもソースは同梱されておらず、依存もしていない。
参照資料
- README.md:概要・前提・注意・主な機能(English・繁體中文)
- hub/README.md:使い方・できること・仕組み・使う前に知っておくこと
- hub/CHANGELOG.md:変更の記録
- hub/package.json:版と動作環境
- Windows 専用窓の案内
- アイデア帳の説明
- MetaMuse 連携の説明(非公開資料のためリンクなし)
- LICENSE
- 紹介ページ:https://k-onedot.com/ai/project-hub/
- リリース:https://github.com/kieiken/project-hub/releases