Tmux-AI-Team：tmux と Claude Code による多Agent 開発自動化

Tool
Tmux-AI-Team：tmux と Claude Code による多Agent 開発自動化

Tmux-AI-Team：tmux と Claude Code による多Agent 開発自動化

Tmux-AI-Team は、tmux と Claude Code CLI を組み合わせて「自主的に動く」複数AIエージェントによる開発ワークフローを構築するツールキットです。tmux セッションごとに Agent を起動し、tmux メッセージでエージェント間通信、`at` による自己スケジューリング、定期的な自動 Git コミット、PM 監督モードや環境自検機能などを提供。ローカル環境（Linux/macOS/WSL）で Claude Code を使った自動化実験を素早く開始できます。（約300字）

https://github.com/coolwoo/Tmux-AI-Team

概要

Tmux-AI-Team は、tmux と Claude Code CLI を核に、複数の自主エージェント（Developer、QA、DevOps、Reviewer、PM など）をローカルで動かし、プロジェクト開発を自動化するツールキットです。各エージェントは独立した tmux セッションで稼働し、tmux のメッセージ機能を介してセッション間通信を行います。エージェントは at を使って自分の次回チェックをスケジュールでき、必要に応じて自動 Git コミットを行う設定も可能。環境依存のチェックとインストール提案機能を備え、Linux / macOS / WSL 上で Claude Code ベースの自律型ワークフローを手早く試すための土台を提供します。

GitHub

リポジトリの統計情報

  • スター数: 1
  • フォーク数: 0
  • ウォッチャー数: 1
  • コミット数: 29
  • ファイル数: 8
  • メインの言語: Shell

主な特徴

  • tmux セッションごとに Claude Code ベースのエージェントを起動して自主開発を実行
  • at コマンドでエージェントが自ら次回実行をスケジューリング（自調度）
  • tmux を介したセッション間メッセージで多 Agent 間の通信を実現
  • PM 監督モード、定期自動 Git コミット、環境自検などチーム運用向け機能

技術的なポイント

本プロジェクトはシェルベースのスクリプト群と外部 CLI（Claude Code）を組み合わせ、ローカルの tmux セッションをそのまま「軽量な実行環境」として利用することで、分散エージェントワークフローを単一マシン上で簡潔に構築しています。主要な技術要素は次の通りです。

  1. tmux をランタイム基盤として利用

    • 各エージェントは独立した tmux ウィンドウ／セッションで実行され、ログ表示や手動介入が容易。tmux の send-keys / display-message / pipe-pane 等を利用してプロセス間通信やログ収集を行う運用が想定されます。tmux による断続的な入出力の取り扱いは、開発者が直接セッションに入って観察・操作できる点でデバッグ性に優れます。

  2. Claude Code CLI をエージェントの思考エンジンに使用

    • 実際のコード生成・解析・判断は Claude Code（外部の LLM CLI）に依存します。シェルスクリプトは Claude との対話をラップし、入力プロンプトの生成や出力の取り扱い、生成物のリポジトリ反映（git add/commit/push）のパイプラインを担います。これにより AI による自律的開発ループを実現します。

  3. 自己スケジューリングとタスク持続性

    • at を利用することで、エージェント自身が次回のチェックタイミングを OS レベルでスケジュールできる仕組みを採用。これにより常駐プロセスを必要とせず、定期的／条件発火型のワークフローを簡潔に実装できます。注意点として atd の有効化や権限設定は環境依存です。

  4. マルチエージェント協調と PM 監督

    • 「PM 監督モード」は別のエージェントが他のエージェントの出力や進捗を監視・評価し、指示を出す役割を担います。これにより人間のプロジェクトマネージャーの一部を自動化する試みが行われています。実装上は tmux を介したメッセージ交換や共有ファイル（リポジトリ）を通じて調整が行われます。

  5. 環境自検と導入の簡便化

    • スクリプトは実行環境（tmux、at、Claude Code CLI 等）の存在をチェックし、足りないものに対するインストール手順や注意点を出力します。ローカルでの検証を迅速に行えるため、試験的な自動化実験の敷居が下がります。

留意点と拡張性：

  • セキュリティ面では Claude Code の API キーやリポジトリの自動コミット権限を取り扱うため、キー管理と実行環境の分離（コンテナ化や専用 VM）が望ましいです。
  • ロギング・障害復旧は現状限定的なため、永続化（外部ログ、ジョブキュー）やリトライ戦略の追加で信頼性が向上します。
  • 単一マシン上の tmux ベース構成は素早く試せる反面、スケールアウトや分散実行にはメッセージキューやリモートエージェント管理（SSH/コンテナ編成）への拡張が必要です。
  • at の代替として systemd タイマーや cron、あるいはプロセス監視ツールを組み合わせることで運用の柔軟性が増します。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .claude: dir
  • .gitignore: file
  • AI-Project-Automation-Manual-v2.md: file
  • CLAUDE.md: file
  • README.md: file

…他 3 ファイル

まとめ

tmux と Claude Code を組み合わせ、ローカルで手軽に多 Agent 開発ワークフローを試せる実験的ツールキットです。運用面の強化で実用性が増します。

リポジトリ情報：

  • 名前: Tmux-AI-Team
  • 説明: AI 项目自动化工具包 - 将 tmux 与 Claude Code 集成，实现自主多 Agent 开发工作流。 核心功能： - 在 tmux 会话中启动 Claude Code Agent 进行自主开发 - 自调度：Agent 使用 at 命令安排下次检查时间 - 多 Agent 通信：通过 tmux 消息传递实现跨会话通信 - PM 监督模式：AI 项目经理自动监督 Engineer Agent - 环境自检：自动检测依赖并提供安装建议
  • スター数: 1
  • 言語: Shell
  • URL: https://github.com/coolwoo/Tmux-AI-Team
  • オーナー: coolwoo
  • アバター: https://avatars.githubusercontent.com/u/10766059?v=4

READMEの抜粋：

Tmux-AI-Team

AI 项目自动化工具包 - 将 tmux 与 Claude Code 集成，实现自主多 Agent 开发工作流。

功能特性

  • 自主开发: 在 tmux 会话中启动 Claude Code Agent 进行项目开发
  • 自调度: Agent 可使用 at 命令安排自己的下次检查时间
  • 多 Agent 通信: 通过 tmux 消息传递实现跨会话通信
  • 自动 Git 提交: 可配置间隔的定时提交
  • PM 监督模式: AI 项目经理自动监督开发 Agent
  • 团队协作: 支持 Developer、QA、DevOps、Reviewer 等角色
  • 环境自检: 自动检测依赖并提供系统对应的安装建议

系统要求

  • Linux / macOS / WSL
  • tmux
  • Claude Code CLI
  • at 命令 (用于自调度功能)

安装

1. 克隆仓库

git clone https...