Claude Session Share

claude-session-share

Render [Claude Code](https://claude.ai/code) JSONL session transcripts as styled HTML pages and upload to any S3-compatible storage for sharing.

**[Live demo →](https://jfdi.bot/session-demo)**

[](https://jfdi.bot/session-demo)

What it does

• Parses Claude Code .jsonl session files
• Renders a clean, readable HTML page with syntax-highlighted code, collapsible tool calls, thinking blocks, and image support
• Uploads to S3-compatible storage (AWS S3, DigitalOcean Spaces, Cloudflare R2, MinIO, etc.)
• Or writes the HTML locally with --output
• Sensitive bash commands (credentials, tokens) are suppressed automatically — nothing leaks to the rendered page

Requirements

• Bun v1.0+

Setup

git clone https://github.com/alexknowshtml/claude-session-share
cd claude-session-share
bun install

Usage

# Interactive session picker
bun session-share.ts

# Render a specific session
bun session-share.ts ~/.claude/projects/my-project/abc123.jsonl

# Write to local file instead of uploading
bun session-share.ts ~/.claude/projects/my-project/abc123.jsonl --output session.html

Upload Configuration

Set these environment variables to enable S3 upload:

Variable	Required	Description
AWS_ACCESS_KEY_ID	Yes	S3 access key
AWS_SECRET_ACCESS_KEY	Yes	S3 secret key
S3_BUCKET	Yes	Bucket name
AWS_ENDPOINT_URL	No	Custom endpoint for non-AWS providers
AWS_REGION	No	Region (default: us-east-1)
S3_PREFIX	No	Key prefix (default: public/)
S3_PUBLIC_URL	No	Override the public URL base
SESSION_SHARE_SYSTEM_FILTER	No	String pattern marking agent-injected system messages (see below)

DigitalOcean Spaces example

export AWS_ACCESS_KEY_ID=your_key
export AWS_SECRET_ACCESS_KEY=your_secret
export AWS_ENDPOINT_URL=https://nyc3.digitaloceanspaces.com
export AW