Docktree：複数のDocker Composeインスタンスをエージェント用に同時実行するCLIツール
Docktreeは、Docker Composeのホストポート・コンテナ名・ボリュームの競合を解決するCLIツール。Composeファイルを編集せずに動的にオーバーライドを生成し、ユニークなポート割り当てやネットワーク・名前付きボリュームの分離、明示的なコンテナ名の書き換えを自動実行。複数ブランチの同一スタックを同時に稼働させられるほか、PostgreSQL/MySQLの論理分離や組み込みリバースプロキシ、Cloudflare/ngrokによる外部公開トンネルにも対応。エージェント用の--json出力やスキル機能も備える。
背景メモ
- Docker Compose は複数コンテナからなるアプリケーションを YAML 設定ファイルで一括管理するツール。通常、同一マシンで同じ Compose ファイルを使う複数のプロジェクトを立ち上げると、ホスト側のポート番号やコンテナ名が重複してエラーになる。
- 「Agent（エージェント）」とは、ここでは AI モデル（LLM）を活用して自律的にコードを書いたりアプリを実行・テストしたりするプログラムのこと。複数のエージェントが同時に異なる機能やブランチを開発するケースでは、それぞれ独立した実行環境が必要になる。
- Docktree は、既存の Compose ファイルを書き換えずに動的にオーバーライド設定を生成し、ポート番号やコンテナ名の衝突を自動回避する CLI ツール。内蔵リバースプロキシにより各サービスをサブドメイン（例：feature-branch.localhost）でアクセス可能にするほか、外部公開トンネルやデータベースの論理分離モードも提供する。
- 従来の代替手段（手動で -p フラグや .env ファイルを管理する方法、Docker-in-Docker や Compose ファイルの書き換えが必要なツール群）と比較して、既存の Compose 設定をそのまま使いながら複数インスタンスを並行動作させる点が特徴。