複数のパソコンの AI コーディング履歴をまとめる

CodeSesh Hub と Worker で複数端末の会話を一か所に集約します。役割の違い、ローカルとリモートのペアリング、同期状況の確認を説明します。

著者:CodeSesh更新日

CodeSesh は複数のパソコンの AI コーディング履歴を一つの Hub に集約できます。履歴を保存して閲覧する端末で Hub を動かし、元の会話がある各端末で Worker をペアリングします。Worker は自分の Hub に送信します。Hub 本機も自動収集の対象にはなりません。

Hub とコンソールを起動する

各端末に CodeSesh をインストールします。信頼できる LAN で使う場合、既存の単体モードを停止してから起動します。

codesesh hub start --host 0.0.0.0 --remote-access --port 4521
codesesh hub status

別の設定の Hub が起動済みなら先に停止してください。LAN 接続ガイドに従ってトークン付きのコンソールを開き、ファイアウォールを確認します。公衆ネットワークから接続する場合は、Worker が信頼する証明書の HTTPS を使います。

最初の Worker をペアリングする

Hub の Web 画面でソースノードのページを開き、ペアリングトークンを発行します。収集する端末で実行します。

codesesh worker start --hub http://192.168.1.20:4521 --name laptop --pair-token-stdin

IP は自分の Hub に置き換えます。入力を求められたらトークンを貼り付けます。トークンは十分間有効で、一度だけ使用できます。--pair-token-stdin を使うとコマンド引数やシェル履歴にトークンを残さず入力できます。

ブラウザー用トークンはペアリング用ではありません。ペアリング後は Worker が専用の認証情報を保存し、通常の再起動で再発行する必要はありません。

Hub 本機も収集する

コンソールで別のペアリングトークンを発行し、本機で独立した Worker を起動します。

codesesh worker start --hub http://127.0.0.1:4521 --name desktop --pair-token-stdin

他の端末でも個別にペアリングします。各 Worker は自分の状態と認証情報を使います。収集対象を絞るには初回の設定に --agent claudecode,codex を追加します。既定では有効な Agent の発見可能な全履歴を収集し、Hub 側の期間指定で表示範囲を選びます。

別の Hub に接続する端末で旧単体モードのデータベースが見つかると、--history import または --history ignore が必要になる場合があります。前者は旧アーカイブを取り込み、後者はそれを除外しますが、読み取れる元のログは引き続き収集します。選択したフラグを完全なペアリングコマンドに追加して再実行します。同じデータディレクトリの Hub に接続するローカル Worker は、既存の本機履歴を引き継げます。

同期状況を確認する

codesesh worker status
codesesh hub status

ソースノードの画面には最終接続、未送信バッチ数、バイト数、収集エラーが表示されます。バッチ数は通信操作の数で、会話数ではありません。接続済みでも未送信データが残ることがあります。

Hub が一時的に停止しても Worker は収集を続け、未送信データを自身のデータベースに保存します。復旧後は保存済み認証情報で再接続させてください。一時的な通信障害の対処として Worker の状態を削除しないでください。認証やバージョンの問題は表示された理由を確認し、Hub を先に更新します。

ソース別に閲覧する

ソースの選択で一台分または全体を確認できます。プロジェクトのグループ化によって他のソースを偽装できるわけではありません。この構成はコンソールトークンで使う履歴ビューアーであり、個別アカウント権限を持つワークスペースではありません。

再起動、設定変更、ログの場所はバックグラウンド実行ガイドで説明しています。

すべてのガイド