Session Kit – A Terminal Dashboard for Claude Code & Codex Sessions

What it is – Session Kit is a small, locally‑run command‑line tool that lets you see, organise, and jump between multiple Claude Code or Codex AI coding sessions. It works on Linux (systemd) and macOS 14+, and survives terminal or SSH disconnects.

Why it exists – The author often runs several AI‑assisted coding sessions at once. Keeping each session alive is easy, but remembering which one is waiting for input, which is still working, or which has finished is hard. Session Kit gives a single, colour‑coded list where each session has a stable number you can type to return to it.

Key features

• Unified picker – One screen shows every Claude Code and Codex session, with columns for number, name, provider, account, model, state, and last activity.
• State hints – Sessions are labelled question, needs you, working, idle or pending so you can spot the ones that need attention.
• Number‑based jump – Press the session’s number (or Enter for the first) and the tool attaches you to that live session.
• Survive disconnects – Sessions keep running on the host even if you close the terminal or lose SSH.
• Per‑session accounts – Each session can use a different provider account/subscription; the account is a property of the session, not of the terminal.
• Closed‑session restore – When you close a session the full conversation is saved and can be reopened later.
• Delegated work isolation – Machine‑origin sessions get their own Git worktree on a dedicated branch, preventing two workers from editing the same files.
• Safety model – The UI (picker) is never trusted as proof of a live session. Before any mutation Session Kit re‑verifies the exact provider process UUID and generation; if the proof fails the action is refused.
• No telemetry – All data stays on the host; there is no remote service, analytics, or update beacon.

How it works (high‑level)

1. You install Session Kit on the machine where the AI work runs (Linux with systemd or macOS 14+). It depends on the shpool session manager.
2. Running kit launches the picker UI.
3. Selecting a session (by number or Enter) re‑attaches to the underlying shpool‑managed shell that is running Claude Code or Codex.
4. When you close a terminal, the shpool process keeps the AI session alive; reconnecting later shows the same session number.
5. All actions (open, close, move) are guarded by a short‑lived proof that the live provider process matches the stored identity.

Installation – The README provides two paths:

• AI‑assistant shortcut – Give the AI a block of commands that downloads the latest release assets, verifies the SHA‑256 checksum, runs ./install.sh --check (read‑only pre‑flight), then ./install.sh, followed by session-kit doctor and session-kit services enable.
• Manual script – A short Python snippet queries the GitHub releases API, downloads the tarball and checksum files, verifies them, extracts, and runs the install script.

Typical workflow

# 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

What it does NOT do

• It isn’t a terminal multiplexer (no tmux replacement).
• It doesn’t track token costs or provide a diff of code changes.
• It isn’t a security sandbox; it only protects you from acting on the wrong session.

Documentation & help – The repo contains a docs/ folder with focused guides:

• install.md – all install routes and shpool details.
• usage.md – commands like sp new, sp close, sp account enroll.
• configuration.md – colour, picker behaviour, watchdog settings.
• picker-navigation.md – key bindings and mouse actions.
• security-and-data.md – privacy model and optional history storage.

Maturity – Public beta v0.4.3. The core picker, identity proofs, and Claude Code/Codex integrations are stable; the project updates quickly (13 releases in three weeks). No formal support, but the author responds to issues and pushes security fixes.

---

Session Kit is a genuine, open‑source utility for managing multiple AI coding sessions, aimed at developers who use Claude Code or Codex heavily and need a reliable way to keep track of them.