ターミナル・マルチプレクサ (tmux/screen) vs Docker 比較ガイド¶

📁 docs/dev-environment/artifact/20260429_224351_tmux_vs_docker_comparison.md

本ドキュメントでは、AIエージェント（Antigravity/Claude）などの長時間を要するタスクをバックグラウンドで実行・管理する際の、tmux/screen と Docker の違いについてまとめます。

1. 概要比較¶

項目	tmux / screen	Docker
分類	ターミナル・マルチプレクサ	コンテナ仮想化プラットフォーム
主な目的	セッションの維持・複数ウィンドウ管理	実行環境の標準化・分離・ポータビリティ
動作環境	ホストOS上で直接動作	ホストOS上の隔離された「コンテナ」内で動作
永続性	ターミナルを閉じてもプロセスが存続	コンテナを停止しない限りプロセスが存続
学習コスト	低（数個のショートカットのみ）	中〜高（Dockerfile/Composeの知識が必要）

tmux/screen: あなたの現在の開発環境（Mac）でそのまま動きます。インストール済みのライブラリやパスがそのまま使えます。
Docker: OS（Linuxなど）から再構築されたクリーンな環境で動きます。依存関係がすべてパッケージ化されているため、他のPCでも全く同じように動きます。

tmux/screen: ホストOSの認証情報を引き継ぎます。git のSSH鍵や gh (GitHub CLI) のログイン状態がそのまま有効です。
Docker: コンテナは独立しているため、そのままではホストの鍵やトークンにアクセスできません。環境変数やマウント設定で明示的に渡す必要があります。

tmux/screen: 実行中の画面を「そのまま」保存します。claude のような豪華なUIを持つツールを表示したままデタッチ（非表示）し、後で全く同じ画面に戻って状況を確認できます。また、再アタッチ時にスクロールバック（過去の出力履歴）がすべて保持されているため、エージェントが過去に何をしたかという「コンテキスト」を失わずに作業を継続できます。
Docker: 基本的にバックグラウンド実行が得意です。実行中の画面をリアルタイムで見るには docker logs -f や docker attach を使いますが、TUIツールの表示が崩れることがあります。

ローカル開発の自動化: agent_issue_executor.py のように、ローカルのソースコードを書き換え、ローカルの認証情報でプッシュする場合。
一時的な長時間タスク: 数時間で終わるスクリプトを動かしっぱなしにして、時々進捗を覗きたい場合。
TUIツールの使用: claude や htop のようなインタラクティブな画面を維持したい場合。

tmux でエージェントを運用する際、最も注意すべきは 「コンテキスト（記憶）の肥大化」 です。

イシューごとにリセット: 全く別のタスクに移る際は、言葉で指示するのではなく、一度エージェントを終了（Exit）してプロセスを再起動してください。
自動化の活用: 今回作成した agent_issue_executor.py のように、タスクごとにプロセスを立ち上げる設計にすることで、常にクリーンなコンテキストで作業させることが可能です。

現在の MyLab 環境でのエージェント活用においては、以下の構成を推奨します。

対話型・開発タスク (Claude/Antigravity):
- tmux を推奨。
- 理由: あなたの Git 権限でコードを修正し、進捗をリアルタイムに確認・介入できるため。
非同期監視タスク (Background Worker):
- Docker を検討。
- 理由: Issueのラベルを10分おきに見るだけのような、UIを必要としない「常駐プログラム」にはDockerの安定性が適しているため。