dob323/session-kit

Close the terminal windows, not the AI coding sessions. One number takes you back in. Every Claude Code and Codex session in one menu: named, numbered, colour-coded. Open, close, and jump to whichever needs you.

Session Kit – Claude Code および Codex セッション用のターミナルダッシュボード

これは何か – Session Kit は、複数の Claude Code または Codex AI コーディングセッションを表示、整理、および切り替えることができる、小型のローカル実行コマンドラインツールです。Linux (systemd) および macOS 14+ で動作し、ターミナルや SSH の切断後も存続します。

なぜ存在するのか – 著者はよく複数の AI 支援コーディングセッションを同時に実行します。各セッションを維持するのは簡単ですが、どれが入力待ちで、どれがまだ作業中で、どれが終了したかを覚えておくのは困難です。Session Kit は単一の色分けされたリストを提供し、各セッションには戻るためにタイプできる安定した番号が付いています。

主な機能

  • 統合ピッカー – 1 つの画面にすべての Claude Code および Codex セッションが表示され、番号、名前、プロバイダー、アカウント、モデル、状態、最終アクティビティの列があります。
  • 状態ヒント – セッションには questionneeds youworkingidle、または pending というラベルが付けられ、注意が必要なものを簡単に見つけられます。
  • 番号ベースのジャンプ – セッションの番号を押す(または最初のものには Enter)と、ツールがそのライブセッションにアタッチします。
  • 切断への耐性 – ターミナルを閉じたり SSH 接続が失われたりしても、セッションはホスト上で実行され続けます。
  • セッションごとのアカウント – 各セッションは異なるプロバイダーアカウント/サブスクリプションを使用できます。アカウントはターミナルではなく、セッションのプロパティです。
  • クローズされたセッションの復元 – セッションを閉じると、完全な会話が保存され、後で再開できます。
  • 委任された作業の分離 – マシン発信のセッションは専用ブランチ上の独自の Git ワークツリーを取得し、2 つのワーカーが同じファイルを編集するのを防ぎます。
  • 安全モデル – UI(ピッカー)はライブセッションの証明として決して信頼されません。変更を行う前に、Session Kit は正確なプロバイダープロセスの UUID と世代を再検証します。証明が失敗した場合、アクションは拒否されます。
  • テレメトリなし – すべてのデータはホストに留まります。リモートサービス、分析、更新ビーコンはありません。

仕組み(概要)

  1. AI 作業を実行するマシン(systemd を搭載した Linux または macOS 14+)に Session Kit をインストールします。これは shpool セッションマネージャーに依存します。
  2. kit を実行するとピッカー UI が起動します。
  3. セッションを選択する(番号または Enter で)と、Claude Code または Codex を実行している shpool 管理下のシェルに再アタッチされます。
  4. ターミナルを閉じても、shpool プロセスが AI セッションを維持します。後で再接続すると同じセッション番号が表示されます。
  5. すべてのアクション(開く、閉じる、移動)は、ライブプロバイダープロセスが保存された ID と一致するという短命の証明によって保護されています。

インストール – README は 2 つのパスを提供しています:

  • AI アシスタントのショートカット – 最新のリリースアセットをダウンロードし、SHA-256 チェックサムを検証し、./install.sh --check(読み取り専用のプレフライト)を実行し、その後 ./install.sh を実行し、続いて session-kit doctorsession-kit services enable を実行するコマンドのブロックを AI に提供します。
  • 手動スクリプト – 短い Python スニペットが GitHub リリース API を照会し、tarball とチェックサムファイルをダウンロードして検証し、展開してインストールスクリプトを実行します。

典型的なワークフロー

# start the picker
kit

# open a new session (defaults to Claude Code)
sp new claude

# open a Codex session
sp new codex

# see which sessions need a reply
kit   # then press 'a'

# close a session by number
k 3   # from the picker

やらないこと

  • ターミナルマルチプレクサ(tmux の代替)ではありません。
  • トークンコストを追跡したり、コード変更の diff を提供したりしません。
  • セキュリティサンドボックスではありません。間違ったセッションでアクションを実行することから保護するだけです。

ドキュメントとヘルプ – リポジトリには焦点を絞ったガイドを含む docs/ フォルダがあります:

  • install.md – すべてのインストールルートと shpool の詳細。
  • usage.mdsp newsp closesp account enroll などのコマンド。
  • configuration.md – 色、ピッカーの動作、ウォッチドッグの設定。
  • picker-navigation.md – キーバインドとマウスアクション。
  • security-and-data.md – プライバシーモデルとオプションの履歴ストレージ。

成熟度 – パブリックベータ v0.4.3。コアピッカー、ID 証明、および Claude Code/Codex 統合は安定しています。プロジェクトは迅速に更新されます(3 週間で 13 回のリリース)。正式なサポートはありませんが、著者は問題に対応し、セキュリティ修正をプッシュしています。


Session Kit は、複数の AI コーディングセッションを管理するための真のオープンソースユーティリティであり、Claude Code または Codex を多用し、それらを追跡するための信頼できる方法を必要とする開発者向けです。

関連

  • Dispatch
  • プロジェクト
  • プロジェクト
  • プロジェクト