チャットワークスペース

チャットワークスペースは、上に会話を、下にエージェントのチームを置きます。チャットで話す相手は リードエージェント（Claude Code）1 人です。リードは作業を計画して ワーカー に分けて任せ、その成果を レビュアー に確認させることができます。全員がチャットの下のグリッドでそれぞれのターミナルで動くので、チーム全体の様子を一度に見られます。

開き方#

• スタートページ（または 新しいワークスペース）で チャット · チーム を選び、プロジェクトフォルダを選びます。
• またはタブ横の + メニューから 新しいチャットワークスペース を選びます。

チャットのブランチ#

git リポジトリでは、チャットごとに専用のブランチ（agentty/chat-…、チャットのバーに表示）が作られ、リードはそのブランチのワークツリーで作業します。プロジェクトフォルダには触れません。

• 各ワーカーは新しいブランチのワークツリーを受け取ります。そのブランチは チャットのブランチの最新コミット から始まるので、リードがすでにマージした作業を次のワーカーが引き継げます。
• リードは作業を確認してから、ワーカーのブランチをチャットのブランチにマージします。
• 結果がプロジェクトフォルダに届くのは、求めたときだけです。リモートがあればリードがプルリクエストを開き、なければプロジェクトフォルダに未コミットの変更がないときにそこへマージします。

コミットが 1 つもないリポジトリには分岐元がありません。その場合リードはプロジェクトフォルダで作業し、リードが最初のコミットを作った後、ワーカーは既定ブランチから始まります。

仕組み#

1. チャットに書きます。Enter で送信、Shift+Enter で改行です。
2. 小さなことはリード自身が答えます。大きな作業は計画を立て、agentty tasks でワーカーを起動します。チャットワークスペースでは通常の確認ダイアログなしにすぐ始まります。チャットを開いたことが同意です。
3. ワーカーはチャットの下のグリッドに 1 行 2 つずつ、レビュアーを含めて同時に最大 4 個まで表示されます。4 つの枠が埋まっていると、最も早く終わったものが閉じて次に場所を譲ります。そのブランチとセッションは残るので、セッション一覧から再開できます。
4. ワーカーがターンを終えると、Agentty がリードに短い報告を送ります。報告にはワーカー名、ブランチ、フォルダ、最後の返答が入っています。リードは作業を確認してマージするか、チャットで伝えるか、ワーカーに追加の指示を送ります。

チャットの上のバーには、リードの状態、チャットのブランチ、ワーカーごとのチップが表示されます。チップをクリックするとそのワーカーのターミナルに移動します。ワーカーが承認や回答を待っているときは、チャットにも表示されます。

ワーカーとレビュアー#

チャットのバーにある 2 つのボタンで、誰が作業するかを選びます。

レビュアー はワーカーのフォルダで起動し、チャットのブランチとの差分を読みます。テストは実行でき、何も変更しないよう指示されます。Codex は読み取り専用サンドボックスで動き、Claude Code は編集ツールなしで動きます（シェルからは書き込めるため、その場合は指示に頼ります）。最後は Verdict: approve か Verdict: changes needed で終わり、その報告はワーカーの報告と同じようにリードに届きます。レビュアーがオフでもリードはレビュアーを起動でき、そのときもボタンで選んだエージェントが使われます。

選択はチャットと一緒に保存されます。

リードのターミナル#

チャットは実際の Claude Code セッションを表示する画面です。バーの ターミナル でリードのターミナルを表示し、チャット で戻ります。ターミナルでしか答えられないときは、ターミナルが自動で表示されます。

• 初回起動時のフォルダの信頼確認やサインイン
• リードのツール承認や質問

そこで答えるとチャットに戻ります。その間に届いたメッセージは、リードが受け取れるようになるまで待ちます。エージェントの画面に承認や質問が表示されている間、Agentty は何も入力しません。

リードが使うコマンド#

これらのコマンドはチャットワークスペースのリードだけが、自分のワーカーに対してのみ使えます。

プランの使用量#

ワーカーとレビュアーは、リードと同じプランを使います。チャットのバーには、このチャットが使うプランの使用量が表示されます。Claude は常に、Codex はワーカーやレビュアーが使うときに表示されます。5 時間の枠と週間の枠のうち、先に上限に近づく方を表示し、マウスを重ねるとリセットまでの時間がわかります。70 % からオレンジ、85 % から赤になります。

85 % を超えると、会話の上に警告が表示されます。プランがどれだけ埋まっているか、いま何個のエージェントがそれを使っているかを伝えます。上限に達すると全員が途中で止まるためです。リードもワーカーを起動するときに同じ内容を受け取るので、ユーザーに伝え、必要な数だけワーカーを起動します。

スマートフォンから#

リモートアクセス がオンなら、チャットワークスペースはリモートページでチャットとして開きます。会話、チャットのブランチ、ワーカーとレビュアーの選択、プランの使用量が表示され、下の入力欄からリードにメッセージを送れます。上の ターミナル でリードのターミナルに、チャット でチャットに戻ります。リードが承認や回答を待っている間は、ターミナルが自動で表示されます。ワーカーのターミナルは分割ペインの一覧にあります。

知っておくと便利なこと#

• ワーカーは自分のブランチにコミットします。プッシュやプルリクエストの作成は、リードに頼んだときだけ行います。
• ワーカーとレビュアーはそれぞれが完全なエージェントセッションなので、4 人同時に動かすと 1 人のときよりプランの上限を早く消費します。
• チャットとグリッドの境界線をドラッグすると、どちらかを広げられます。レイアウトはワークスペースと一緒に保存されます。
• 設定で エージェントが並列タスクを開始できる をオフにすると、チャットのリードもワーカーを起動できなくなります。
• チャットのブランチ機能より前に開いたチャットは、引き続きプロジェクトフォルダで作業します。