umputun/agterm

agterm – フルコントロールAPIを備えたミニマルなmacOSターミナル

概要

Ghostty レンダリングエンジンをベースにしたネイティブmacOSターミナルアプリケーションです。ワークスペース（セッションの名前付きグループ）に焦点を当てた小さなUIと、プログラム可能なコントロールサーフェスを提供します。

主な機能

ワークスペース＆セッション – 各ワークスペースは複数の名前付きシェルセッションを保持し、別のセッションに切り替えても実行を継続します。
コントロールAPI（agtermctl） – コマンドラインツールがローカルのUnixソケットを介して実行中のagtermと通信します。スクリプト（またはAIエージェント）は、セッションの作成、セッションへのタイピング、ペイン分割、オーバーレイプログラムの起動、端末テキストの読み戻し、ステータスアイコンの設定、ネイティブピッカーの表示などを行うことができます。
分割、スクラッチペイン＆オーバーレイ – セッションを水平または垂直に分割したり、一時的な「スクラッチ」ターミナルを開いたり、基になるシェルを妨げずにフルスクリーン/フローティングオーバーレイを実行したりできます。
復元モード – 再起動時に新しいシェルを取得したり、アクティブだったコマンドを再実行したり、zmxデーモンを使用して元のプロセスを維持（ライブモード）したりできます。
エージェント統合 – オプションのスキルプラグインがClaude Code、Codex、または他のエージェントにagtermctlコマンドを教え、AIエージェントが独自のレイアウトを調整し、オーバーレイを実行し、サイドバーで状態（アクティブ、ブロック済み、完了）を直接報告できるようにします。
拡張性 – キーバインドはkeymap.confで定義されます。任意のコマンドをキーコードにバインドでき、1行を強力なUIアクションに変えることができます。

使用方法

# ワークスペースとセッションを作成
ws=$(agtermctl workspace new demo)
sid=$(agtermctl session new --workspace "$ws" --cwd "$PWD" --no-select)

# セッションを垂直に分割
agtermctl session split on --axis horizontal --target "$sid"

# 非表示のセッションにコマンドを入力
agtermctl session type $'pwd\n' --target "$sid"

# 出力の最後の10行を読み取る
agtermctl session text --target "$sid" --lines 10

このAPIは、ウィンドウ、ペイン、オーバーレイ、通知、ピッカー、モデル全体のJSONダンプもカバーします。

インストール

AppleシリコンMac用の署名済み.dmg（macOS 14+）として配布されています。
Homebrew Caskからも入手可能：brew install --cask umputun/apps/agterm（agtermctlバイナリを含む）。
オプションのエージェントスキルプラグインは、ターミナルのヘルプメニューまたはClaude/Codexプラグインコマンドを介してインストールできます。

対象ユーザー

多くの長期実行コーディングエージェントやバックグラウンドプロセスを実行し、明確な視覚的概要を必要とする開発者。
ターミナルレイアウトをスクリプト化し、ウィンドウ管理を自動化したいパワーユーザー。
手動ではなくプログラムで駆動できる軽量macOSターミナルを求めるすべての人。

関連プロジェクト

agterm-linux – Linux用のGTK4ポート。
agwinterm – Windows向けの再実装。
エージェントの状態をリモートのtmuxセッションにプッシュするコンパニオンツールなど。

ライセンス – MIT。

すべての詳細はリポジトリのREADMEから直接取得しています。追加の機能は推測されていません。