Project Hub百科事典風の紹介記事

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 の操作環境
対応 OSmacOS 13 以降(Apple Silicon)、Windows 11 x64
動作環境Node.js 22 以上、Git、利用する AI の CLI
主な実装Node.js(本体)、node-pty(画面内の端末)、xterm.js(端末表示)、Swift と WebKit(Mac の専用窓)、WebView2(Windows の専用窓)
対応 AIClaude 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 のプランと設定に従う。

基本となる考え方

プロジェクト・作業・フェーズ

状態の表示

左のツリーの丸の色で状態を表す。灰はまだ始めていない、赤は AI が作業中、薄緑は処理が終わった、紫は完了(人が[プロジェクトを完了にする]を押した時だけ)、黄は人の返事が必要であることを示す。一覧には「未読」「返事待ち」「完了確認」が文字でも表示され、画面上部の「あなたの番」に返事待ちと完了確認の件数が別々に出る。AI の画面が 20 秒止まると「入力待ち」と表示される。

依頼から取り込みまでの流れ

標準的な流れは次のとおりである。

  1. 始める:プロジェクト画面でやりたいことを書いて[始める]を押すと、作業ができ、会話画面で AI に送られる。担当 AI・モデル・思考の深さを選べ、プロジェクトごとに前回の担当を覚える(初回は Claude Code)。
  2. 作業用コピーの作成:Git のあるプロジェクトでは、作業ごとに作業用コピー(Git の worktree、Work/<プロジェクト>/<作業ID>/)が自動で作られ、AI はそこで作業する。Git の無いプロジェクトでは、始める前に毎回保存してから本体で作業する。
  3. 会話と進行:AI は作業ファイルの手順を更新しながら進める。判断が必要な時は選択肢のボタン付きで質問し、作業は返事待ち(黄)になる。
  4. 完了の確認:手順がすべて済むと「完了確認」になり、人が[完了に移す]か[まだ続ける]を選ぶ。
  5. 成果の記録:作業ファイルの「成果」に、ファイル・本体保存済み(リポジトリとコミット)・なし(理由)のいずれかを書く。記録が整っていない時は、AI が所属や重複を調べて記録を整え、人にファイル名で選ばせない。
  6. 取り込み:通常の作業は[本体に取り込む]で作業用コピーを本体に取り込み、作業用コピーはゴミ箱へ移る。取り込む前には変更の量(ファイル数・行数)と「本体とぶつかりそう」かが表示され、ぶつかった時は取り込まずに「あなたの番」に出る。変更が 0 件の時は取り込みのボタンを表示しない。
  7. 子作業の統合:子作業の成果は親の[統合…]から受け取る。子ごとに[残す/残さない]を選び、[統合][選別統合(件数)][一括統合]で取り込む。未完了の子でも[成果を渡す(途中)]で保存済みの成果を先に渡せ、途中の受け取りでは子の会話・作業用コピー・残りの手順が保持される。片付けは完了した子の最終統合の時だけ行われる。

本体へ取り込まない作業は[取り込み対象から外す]で取り込みボタンを隠せ、あとで[取り込み対象に戻す]で戻せる。

会話画面と作業画面

会話画面

通常使う画面。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・順番待ち・子作業・作業用コピーがある場合は移せない。[整理と確認]の記録から元に戻せる。

添付・閲覧・音声入力

設定と付加機能

仕組み

本体は server.js を中心とした Node.js のプログラムで、127.0.0.1:4545 だけで待ち受け、他のサイトからの操作を受け付けない。画面はブラウザ技術で作られており、Mac では Swift で書かれた専用アプリが本体を起動して WebKit で表示する。Windows ではブラウザで開く方法と、WebView2 を使う専用窓がある。主な部品は次のとおりである。

部品役目
lib/store.js・lib/frontmatter.js台帳と作業ファイルの読み書き
lib/launch.jsAI の起動コマンドの組み立て(画面のモデル名を 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 つ目の数字を上げる。

Project Hub のしくみの図
依頼が Hub と AI を通り、取り込みと公開を人が決めるまでの流れを簡略化した図(開発中のソース、2026年11月時点)。すべての機能を示すものではない。

導入と動作条件

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 で実行する。

安全性と制約

説明書では、使う前に知っておくべき点として次が挙げられている。

沿革

変更の記録に残っている範囲での主な出来事は次のとおり。日付は記録上の日付である。

リポジトリはもともと Discord Bot のテンプレート「discordpy-startup」(MIT)から作り始められた。Bot の部分は公開物に含まれていないが、由来として著作権表示と許諾文が残されている。設計にあたっては、teddashh/bat-agent-connector(入力待ちの見張り、取り込み前の確認、操作の記録)と arumwu/goose-acp-handoff(AI を交代する時の引き継ぎ資料)の考え方を参考にしたとされる。いずれもソースは同梱されておらず、依存もしていない。

参照資料