セッションとワークフロー

Tactic Remote は tmux セッションを使用して、切断をまたいで Claude Code プロセスを維持します。このページではセッションの仕組みと日常のワークフローを説明します。

セッションの仕組み

各セッションは以下に対応：

• 作業ディレクトリ（プロジェクトフォルダ）
• Mac 上の tmux セッション（Claude Code を実行）
• iPhone に表示されるターミナル出力ストリーム

セッションは以下の場合でも維持されます：

• iPhone アプリが閉じられた、またはバックグラウンドに移動
• ネットワークが一時的に切断
• Mac がスリープして復帰

再接続時、アプリはセッションとターミナル出力を復元します。

セッションの作成

1. セッションセレクター（アプリ左上）をタップ
2. New Session をタップ
3. Mac のファイルシステムをブラウズしてプロジェクトディレクトリを選択
4. セッション名を付ける（例：my-api、frontend-work）
5. Create をタップ

異なるプロジェクト用に複数のセッションを作成し、切り替えることができます。

Claude Code の起動

Start ボタンをタップすると、現在のセッションで Claude Code が起動します。

アプリには重複起動防止機能があります：セッションで Claude Code がすでに実行中の場合、Start をタップしても何も起きません。誤って二重起動することを防ぎます。

起動前に確認： ステータスインジケーターを見てください。緑の "Running" は Claude がすでにアクティブ — Start をタップする必要はありません。

プロンプトの送信

チャット入力欄にテキストを入力して送信。プロンプトは WebSocket 経由で Mac に送られ、Claude Code プロセスに渡されます。出力はリアルタイムでストリーミングされます。

クイックアクション

アプリにはターミナル入力用のショートカットボタンがあります：

• Enter — 入力を送信
• Escape — 現在の操作をキャンセル
• Tab — オートコンプリート
• 矢印キー — ナビゲーション
• Ctrl+C — 中断

再接続

アプリが接続を失った場合（ネットワーク変更、バックグラウンド移行など）：

1. 指数バックオフで自動的に再接続を試行
2. 再接続後、既存の tmux セッションに再アタッチ
3. 切断中に蓄積されたターミナル出力が復元

特に操作は不要 — アプリを再開するだけです。

表示が古い場合： セッションセレクターを開いてセッションを再選択。強制的にリフレッシュされます。

通知

長時間タスクでは、アプリを開いたままにする必要はありません：

1. Claude Code は hooks をサポートしており、タスク完了時に発火
2. サーバーがこれらのイベントをプッシュ通知として iPhone にリレー
3. 通知が届いたらアプリを開いて結果を確認

Tactic Remote の iOS 通知権限を有効にしておいてください。

セッションの終了

• Claude を停止： Stop ボタンをタップして Claude Code プロセスを終了。セッションは残り、後から再起動可能。
• セッションを削除： セッションセレクターでスワイプして削除。Mac 上の tmux セッションが削除されます。