tmux-session-manager

name	tmux-session-manager
description	Lightsail上のClaude Code tmuxセッションをSSH経由で管理。 「セッション確認」「PR同期」「tmuxの状態」等のリクエストで発動。
triggers	["セッション確認","セッション一覧","tmuxの状態","PRの進捗確認","セッションに指示","tmux-session-manager","sync-prs"]

Tmux Session Manager Skill

Lightsail 上で稼働する Claude Code tmux セッションを SSH 経由で管理するスキル。 Issue/PR 単位のセッション状況確認、指示送信、PR 同期を行う。

トリガー

以下のキーワードで発動:

• 「セッション確認」「セッション一覧」「tmux の状態」
• 「PR の進捗」「Issue の作業状況」
• 「セッション作成」「PR 同期」「sync-prs」
• 「ダッシュボード」「tmux dashboard」
• 「セッションに指示」「send-keys」

スクリプトパス

リモート (Lightsail) 上:

REPO=/home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata
CC=$REPO/ops/tmux-manager/cc-session.sh
SYNC=$REPO/ops/tmux-manager/sync-prs.sh

コマンド実行方法

全てのコマンドは SSH 経由で実行する。ssh lightsail のエイリアスが ~/.ssh/config に設定済み。

ダッシュボード表示

ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh dashboard"

セッション一覧

ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh list"

セッション状態確認

ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh status PR-45"

セッション出力キャプチャ

# デフォルト100行
ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh capture PR-45"

# 行数指定
ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh capture PR-45 200"

セッション作成

# PR 用
ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh create PR-45"

# Issue 用
ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh create ISSUE-123"

指示送信 (send-keys)

ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh send PR-45 'このPRのレビューコメントに対応して push してください'"

全 Open PR 同期

ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/sync-prs.sh --cleanup"

セッション終了

ssh lightsail "cd /home/runner/actions-runner/_work/githubactions_fordata/githubactions_fordata && bash ops/tmux-manager/cc-session.sh kill PR-45"

ワークフロー

1. 全体状況確認

ユーザーが「セッション確認」「今の状態は？」と聞いた場合:

1. dashboard コマンドで全体概要を表示
2. 必要に応じて個別の status で詳細確認
3. 結果をユーザーに分かりやすく要約して報告

2. PR 同期 + セッション作成

ユーザーが「PR 同期して」「全 PR のセッション作って」と言った場合:

1. sync-prs.sh --cleanup で全 Open PR を同期
2. 結果（作成数、スキップ数、クリーンアップ数）を報告

3. 特定セッションへの指示

ユーザーが「PR-45 にレビュー対応させて」と言った場合:

1. status PR-45 で現在の状態を確認
2. アイドル状態なら send PR-45 "指示内容" で指示を送信
3. 作業中なら「現在作業中です。完了を待ちますか？」と確認

4. セッション出力の確認・要約

ユーザーが「PR-45 で何してる？」と聞いた場合:

1. capture PR-45 100 で最新出力を取得
2. 内容を要約してユーザーに報告

注意事項

• SSH 接続がタイムアウトする場合は -o ConnectTimeout=10 を追加
• 作業中のセッションに send-keys しない（状態を必ず確認）
• セッション数は同時 5 以下を推奨（Lightsail リソース制約）
• ログは ops/tmux-manager/logs/ に保存されている