session-share

CustardSeed

Instantly share your Claude Code sessions online.

A Claude Code slash command which publishes your session transcripts as a github gist, plus an online viewer so you can share your session via a URL.

How it works

The system has two parts:

1. Claude Code plugin - Publishes your current session transcript to a GitHub Gist (secret by default)
2. Web viewer - Renders the transcript stored in any gist in a readable format

GitHub handles storage and access control. The viewer is a static site that fetches transcripts client-side.

Components

Directory	Description
claude-code-session-share	Claude Code plugin for publishing sessions
session-viewer	React app that renders transcripts
infra	Terraform IaC for GCP hosting
docs	Architecture and roadmap
samples	Sample transcripts and tooling

Development

After cloning, set up git hooks:

uvx pre-commit install

Sample transcripts

samples/gist-samples/ is a place to keep a personal corpus of your own published transcripts for use as local test data. It is not pre-populated — each developer builds their own by running:

python3 samples/scripts/fetch_gist_samples.py

This discovers all your CustardSeed gists (via gh api), downloads the JSONL files locally, and generates:

• index.md — human-readable table (entry counts, tools used, subagents, images, thinking)
• index.json — machine-readable metadata for each gist

Raw JSONL files are gitignored; only the index files are committed. Requires gh auth login.

Current status

Phase 1 (MVP) - Public and unlisted sharing via GitHub Gists. No login required to view or publish (just a logged in gh cli, for creating gists).

License

MIT