Agentty/ドキュメント

ワークスペース・タブ・ペイン

Agentty の構造 — プロジェクトごとのワークスペース、その中のタブ、さらにその中のペイン。

Agentty には 3 つの階層があります。ワークスペースはプロジェクト、タブはその中の 1 画面、ペインは 1 つのプログラム(シェル、AI エージェント、ファイルエディタ、ブラウザ)です。

ワークスペース#

サイドバー(⌘B)の各行がワークスペースで、それぞれ開くフォルダを持ちます。⌘N で作成します。

  • 行をドラッグして並べ替え、1 つを別の 1 つに重ねるとグループになります。グループは折りたためます。グループの見出しを右クリックすると、名前の変更、色、すべてスリープ、削除ができます。
  • 一覧の上の検索欄は、名前、フォルダ、その中での会話の内容からワークスペースを探します。検索中は一覧が結果表示に変わり、それぞれどこで一致したかを示します — 名前、フォルダ、または検索語に印が付いた会話の 1 行と、それを言ったのが誰か(自分・エージェント・ツール)。✕ か Esc で検索を消すと一覧全体が戻ります。
  • 1 つのセッションとしてつないだワークスペースは、つなぎ始めたワークスペースの下にまとまります。そのワークスペースが折りたたんだグループの中にあるときは、ほかのワークスペースは元の場所に表示されたままです。
  • 名前をダブルクリックで変更します。
  • ⌥⌘↓ / ⌥⌘↑ で移動、⌘1…⌘9 で直接切り替えます。
  • すべてのワークスペースとそのタブ・分割・グループは、再起動後もそのまま戻ります。
  • 一覧の見出しの ⚙ で ワークスペースのオプション が開きます。カードのレイアウト(詳細・コンパクト、詳細カードに実行中のサブエージェントを出すか — 最大 5 件、残りは「+N」にまとめ、⌘-クリックでサブエージェントのウィンドウが開く — と、エージェントの状態・時間・トークン・金額を出すか)、グループ化(なし・自分のグループ・プロジェクト別 — リポジトリとそのワークツリーをまとめる。プロジェクトもグループと同じく折りたためる)、並べ替え(手動・最近の活動・名前)、フィルター(スリープ中、main/master ブランチ、プラグインのワークスペースを隠す)、タブをタイトルバーに置くかを選べます。開いているワークスペースは常に一覧に残ります。
  • ワークスペースのオプションの並び順の下にある起動中のワークスペースを先にをオンにすると、グループごとに実行中のワークスペースがスリープ中のものより上に来て、それぞれの順序はそのままです。オフにすると元の順序に戻ります。検索欄の右端にある月のアイコン(検索欄をオフにすると見出しに移ります)は、スリープ中のワークスペースを表示または非表示(表示中は星付きの月、非表示中は月だけ)にします。フィルターと同じ設定です。
  • ウィンドウが複数開いているとき(ファイル → 新しいウインドウ、または別アカウントのウィンドウ)、ワークスペースのメニューの 別のウィンドウへ移動 › か、グループのメニューの グループを別のウィンドウへ移動 の下のウィンドウで、そこへ移します。ターミナルは動いたまま、エージェントは始めたアカウントのままセッションを続けます。グループは同じ名前で移ります。
  • ワークスペースのオプション、サイドバーの幅、横のパネルの幅は、メインウィンドウで決めた値をすべてのウィンドウが使います。別のウィンドウで変えると、そのウィンドウだけその値のままになり、そのウィンドウのワークスペースのオプションの一番下の メインウィンドウに合わせる で戻せます。

macOS ではタブがウィンドウボタンの横のタイトルバーにあり、その隣にサイドバーボタン(⌘B)があります。タイトルバーの空いた所をダブルクリックするとウィンドウが拡大します。タブの行を別にするには、ワークスペースのオプションで タブをタイトルバーに置く をオフにします。

ワークスペースの行にはその中のエージェントの状態が出るので、開かなくてもどのプロジェクトが自分を待っているか分かります。エージェントが動いている間は、詳細カードの名前の下に次の行が加わります。

  • ペインのヘッダーと同じ言葉で示す状態、エージェントが動いている時間、セッションが使ったトークン(と金額)
  • ToDo 4/9 のような ToDo リストの進み具合と、いま取りかかっている項目。クリックするとリスト全体が開きます
  • 実行中のサブエージェントごとに、いましていることとかかっている時間、さらに残りと完了したものの件数

状態の行とサブエージェントは、ワークスペースのオプションでそれぞれオフにできます。

ワークスペースのメニュー#

ワークスペースを右クリックするか ⋯ を押すとメニューが開きます。フォルダを扱う項目は、そのワークスペースで選択中のペインのフォルダを使います。

項目内容
次で開く ›このコンピュータにあるエディタや IDE(VS Code、Cursor、Zed、JetBrains の IDE、Xcode など)または Finder でフォルダを開きます
パスをコピーフォルダのパスをコピーします
ワークツリー名をコピー / ブランチ名をコピー専用のワークツリーならその名前を、そうでなければブランチ名をコピーします
固定ワークスペースをグループの一番上に置きます
未読にする開くまでカードに通知マークを表示します
新しいグループ、グループへ移動 ›、グループから外すワークスペースをグループに整理します
別のウィンドウへ移動 ›動いたままワークスペースを開いている別のウィンドウへ移します
親ワークツリーを設定…選んだワークスペースの下にインデントして表示します。グループを移すと一緒に移ります
リモートアクセスで非表示ワークスペースをリモートアクセスから外します。一覧に出ず、そのターミナルにも届きません。もう一度選ぶと元に戻り、非表示の間は ✓ が付きます。リモートアクセス機能がオンのときだけ表示されます
スリープワークスペースのプログラムをすべて終了し、状態はそのまま残します。カードは月のマーク付きで薄く表示されます。Agentty の起動後まだ開いていないワークスペースも同じように表示されます。開き直すとタブが起動し、エージェントのセッションが続きます
ワークツリーを削除ワークスペースを閉じ、そのワークツリーとブランチを削除します。未コミットの変更や他にないコミットは残します
ワークスペースを削除ワークスペースをゴミ箱に移します。ターミナルは閉じて一覧から消え、ゴミ箱から元に戻せます
ゴミ箱を表示ゴミ箱を開きます

タブ#

⌘T でターミナル、⌥⌘C で Claude Code、⌥⌘X で Codex のタブが開きます。+ メニューには同じ項目に加えて、選べるモデルと、マシン上で見つかった他のエージェント CLI が並びます。

  • ⇧⌘] / ⇧⌘[ または ⌃Tab でタブを移動、⌃1…⌃9 で直接切り替えます。
  • ⇧⌘W でタブ、⌘W でペインを閉じます。
  • タブ領域の空白をダブルクリックすると新しいタブが開きます。
  • タブを右クリックして 後で作業する を選ぶと、タブを脇に置きます。中で動いていたものは止まり、スタートページのタブの横の TODO ボタンに並びます。そこでクリックすると再開し、エージェントは続きから作業します。

新しいタブはワークスペースのフォルダで始まります。設定 → 一般で毎回フォルダを尋ねるようにもできます。

ペイン#

⌘D で右に、⇧⌘D で下に分割します。⌘] / ⌘[ でペインを移動し、境界をドラッグしてサイズを変えます。

エージェントのペインには、モデル、コンテキストウィンドウ、利用上限、ブランチ、フォルダ、そしてそのペインで動いているローカルサーバーのポートを示すステータスバーがあります。位置(ターミナルの上か下か)と表示項目は設定 → 外観で決めます。

そのバー(状態の部分、またはドラッグに使うアイコン)をダブルクリックすると、そのペインがタブ全体に広がります。もう一度ダブルクリックすると、元の分割に戻ります。

ペインのヘッダーにはフォルダ名だけが表示されます。フルパスはステータスバーにあります。

サイドパネル#

ターミナルの横に並ぶパネルは、いずれも端をドラッグしてサイズを変えられます。

パネルショートカット
ファイルとワークツリー⌥⌘B
アプリ内ブラウザ⇧⌘B
Dockerステータスバーの 🐳
プラグインパネルタブ領域のボタン

ミニモード#

⌃⌘M はウィンドウを画面端の小さな常時表示パネルに畳みます。作業を終えたエージェントが吹き出しで現れ、クリックすると元のウィンドウに戻ります。

macOS ではメニューバーのアイコンがエージェントの稼働中に動き、一覧を表示し、ウィンドウを閉じても Agentty を動かし続けます。

メニューバーのポップオーバーには、ミニモードボタンの横にコンピュータの CPU と RAM の負荷も表示されます。ポップオーバーを開いているあいだ 2 秒ごとに更新され、85% 以上になるとオレンジ色になります。