tmux-background-tasks

Tmux バックグラウンドタスク

tmux がインストールされていない場合は、作業を中止し、先にインストールするようユーザーに依頼してください。

概要

tmux を使って、長時間実行されるコマンドをバックグラウンドで実行・管理します。これらのタスクを既定のプロセスツールで実行し続けないでください。コマンドの実行後もタスクが継続し、再接続できるよう、必ず tmux で起動してください。

ワークフロー

1. tmux がインストールされていることを確認する tmux が見つからない場合は、作業を中止し、インストールするようユーザーに依頼してください（例：macOS では brew install tmux）。tmux が利用可能になるまで作業を進めないでください。

2. 安定したセッション名を選ぶ <repo>-<task> のような、予測可能で一意の名前を使ってください（例：myapp-api、myapp-expo）。

3. セッションを開始するか、既存のセッションを再利用する 新しいセッションを開始する前に、既存のセッションがないか確認してください。

4. 接続・切断方法を案内する ログを見たり操作したりするためにセッションへ接続する方法をユーザーに伝えてください。

5. 要求に応じて停止または再起動する ユーザーからタスクの停止を求められたら、セッションを適切に終了してください。

コマンドパターン

tmux を確認する：

• command -v tmux
• tmux -V

コマンドを実行する新しいデタッチ済みセッションを作成する：

• tmux new-session -d -s <name> -- <command>
• ログインシェルや環境変数が必要な場合：tmux new-session -d -s <name> -- bash -lc '<command>'

再利用または接続する：

• tmux has-session -t <name>
• tmux attach -t <name>
• tmux ls

停止シグナルを送るか、セッションを終了する：

• tmux send-keys -t <name> C-c
• tmux kill-session -t <name>

直近の出力を確認する（非対話型）：

• tmux capture-pane -pt <name> -S -200

メモ

• ほかのコマンドの実行中も起動しておくサーバー、ウォッチャー、ワーカー、開発ツールには、tmux を優先してください。
• セッションの重複作成は避けてください。tmux has-session -t <name> が成功した場合は、そのセッションを再利用するか、接続してください。