sessionbin CLI

CLI for uploading and managing sessionbin transcripts.

Supported harnesses

Claude Code sessions are read as files from ~/.claude/projects/.

Codex sessions are read as files from ~/.codex/sessions/. Sub-agent rollouts (reviews, spawned agents) are skipped.

Pi sessions are read as files from ~/.pi/agent/sessions/.

OpenCode sessions live in a local SQLite database rather than as files, so uploading one shells out to opencode export. The opencode binary must be on your PATH (or at ~/.opencode/bin/opencode).

Installation

uv tool install sessionbin
# or
pip install --user sessionbin

Usage

Upload a session

Upload a specific file:

sessionbin upload ~/.claude/projects/-home-user-repos-myproject/abc123.jsonl

Or pick from recent sessions interactively (Claude Code, Codex, OpenCode, and Pi):

sessionbin upload

Upload the most recent session directly:

sessionbin upload --latest

Use -y to skip the confirmation prompt:

sessionbin upload --latest -y

List uploads

sessionbin list

Shows locally-tracked uploads (URL, filename, upload time).

Delete an upload

sessionbin delete <slug>

Deletes the paste on the server and removes the local record.

Configuration

On first run, you'll be prompted for a server URL (defaults to https://sessionbin.dev). The choice is saved to ~/.config/sessionbin/config.toml.

You can override the server URL per-command:

sessionbin upload --server http://localhost:8000

Or via environment variable:

export SESSIONBIN_URL=http://localhost:8000

Priority: --server flag > SESSIONBIN_URL env var > config.toml > interactive prompt.

Session data

Upload metadata (slugs, delete tokens) is stored in ~/.config/sessionbin/sessions.json with 0600 permissions. This file is local-only — the list command reads from it without contacting the server.