govijr/terminal-mac

これは何？

主な機能

• 01Apple silicon上で、独自のアプリ、ファイル、アカウントを持つ実際のmacOSゲストを実行します。
• 02Kitty、Ghostty、iTerm2のターミナル内にゲスト画面をインライン表示します。
• 03screenshot、click、drag、scroll、type、key、statusをMCPツールとして公開します。
• 04エージェントによる入力でホストのポインターが動いたり、ホストのクリップボードが変更されたりすることはありません。
• 05curlスクリプトでインストールでき、初回実行時にmacOS復元イメージをダウンロードします。
• 06ターミナルから直接送信できないキーを使うための、MacショートカットのCtrl+Gパレットを提供します。

ユースケース

• 自分のデスクトップを操作させずに、AIエージェントでmacOS専用アプリを操作する。
• 隔離された仮想MacでmacOS GUIソフトウェアをテストする。
• SSHを使わず、ローカルセッションでターミナルから仮想Macを確認・操作する。
• 使い捨てのmacOS環境を必要とするコンピューター操作エージェントの実験を行う。

クイックスタート

1. 1

   README の curl インストーラーでインストールします（SHA-256 を検証）

2. 2

   ガイド付きセットアップを実行して、仮想 Mac をダウンロード、インストール、起動します

   terminal-mac up
3. 3

   MCP 経由で AI エージェントを接続します

   claude mcp add terminal-mac -- terminal-mac mcp

使う前に知っておきたいこと

• !macOS 14 以降を搭載した Apple silicon Mac が必要です。
• !初期リリース候補版です。クリーンな Mac でのゲストの実機受け入れテストはまだ完了していません。
• !リリースは自己署名されており、Apple による notarization は受けていません。
• !インラインビューアーは Ghostty、Kitty、iTerm2 でのみ動作します。

収録されている特集

トピック

よくある質問

terminal-mac とは？

MCPツールでAIエージェントが操作できるmacOS仮想マシン。Kitty、Ghostty、iTerm2のグラフィックスでターミナルに画面を表示します。 terminal-macはAppleのVirtualization frameworkを使い、Apple silicon上で実際のmacOSゲストを実行します。ゲスト内のヘルパーアプリが画面をキャプチャし、キーボードとマウスのイベントを送信するため、エージェントは物理Macのポインターを動かしたりクリップボードに触れたりせずに、別のMacを操作できます。ゲストは独自のアプリ、ファイル、アカウントを持ち、ホストのサインイン済みセッションを引き継ぎません。

terminal-mac は無料で使えますか？ライセンスは？

terminal-mac は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

terminal-mac は今もメンテナンスされていますか？

活発にメンテナンス中。terminal-mac の最終コミットは 2026年11月7日 です。

terminal-mac は何に使えますか？

自分のデスクトップを操作させずに、AIエージェントでmacOS専用アプリを操作する。 隔離された仮想MacでmacOS GUIソフトウェアをテストする。 SSHを使わず、ローカルセッションでターミナルから仮想Macを確認・操作する。 使い捨てのmacOS環境を必要とするコンピューター操作エージェントの実験を行う。

terminal-mac のインストール方法は？

README の curl インストーラーでインストールします（SHA-256 を検証） ガイド付きセットアップを実行して、仮想 Mac をダウンロード、インストール、起動します: terminal-mac up MCP 経由で AI エージェントを接続します: claude mcp add terminal-mac -- terminal-mac mcp

terminal-mac はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/govijr/terminal-mac