Share Transcript

Uploads the current Claude Code session to GitHub Gist and adds it to the project's gist index.

Instructions

Step 1: Find Current Session File

1. Get the current working directory to identify the project
2. Find the most recent session file for this project:

# Extract project path from current directory
PROJECT_PATH=$(pwd)
PROJECT_SLUG=$(echo "$PROJECT_PATH" | sed 's/\//-/g')

# Find most recent session file for this project
SESSION_FILE=$(find ~/.claude/projects -path "*${PROJECT_SLUG}*" -name "*.jsonl" -type f -printf "%T@ %p\n" 2>/dev/null | sort -rn | head -1 | awk '{print $2}')

# Verify file exists
if [ -z "$SESSION_FILE" ]; then
  echo "Error: No session file found for this project"
  exit 1
fi

echo "Found session: $SESSION_FILE"

Step 2: Upload to GitHub Gist

Run the claude-code-transcripts tool:

claude-code-transcripts json --gist "$SESSION_FILE"

This will output something like:

Generated page-001.html
Generated page-002.html
Generated /tmp/claude-session-<id>/index.html (13 prompts, 3 pages)
Creating GitHub gist...
Gist: https://gist.github.com/username/gist-id
Preview: https://gisthost.github.io/?gist-id/index.html

Step 3: Parse Output

Extract the two URLs from the output:

• Look for line starting with "Gist: " to get the gist URL
• Look for line starting with "Preview: " to get the preview URL

Step 4: Get Description from User

Use AskUserQuestion to ask the user for:

Question: "What's a brief description for this session?"

Options:

• "Feature planning session"
• "Implementation work"
• "Debugging session"
• "Architecture discussion"

Allow custom text input via "Other" option.

Also ask for the feature number if relevant (optional).

Step 5: Update gist-list.md

1. Check if aidocs/gist-list.md exists in the current project
2. Get current date in YYYY-MM-DD format
3. Create the new entry:

- **{description}** ({date})
  - Gist: {gist-url}
  - Preview: {preview-url}

4. Append to the file (after the --- separator and any existing entries)

Step 6: Confirm Completion

Display:

• ✅ Gist created successfully
• The preview URL (as a clickable link if possible)
• ✅ Added to aidocs/gist-list.md
• Suggested next action: "Share the preview URL with your team"

Error Handling

If session file not found:

❌ Error: Could not find session file for this project

The session may not have been saved yet, or this directory may not be a Claude Code project.

Try running a command first to ensure a session exists.

If gist upload fails:

❌ Error: Failed to upload gist

Verify GitHub authentication:
  gh auth status
  gh auth login

Then retry: /share-transcript

If gist-list.md doesn't exist: Create it with the header:

# Claude Code Session Gists

Shareable links to notable Claude Code sessions for this project.

---

Example Output

Finding current session...
✓ Found: ~/.claude/projects/-home-cip-src-giant-computer-aegis/af4d62e3.jsonl

Uploading to GitHub Gist...
✓ Generated 3 pages (13 prompts)
✓ Gist created: https://gist.github.com/ianphil/ef6f4483dc1dda8e8865b629e143752f

[User provides description: "Feature 001 MCP Integration - Planning & Work Plan Setup"]

✓ Added to aidocs/gist-list.md

Preview URL: https://gisthost.github.io/?ef6f4483dc1dda8e8865b629e143752f/index.html

Share this URL with your team!

Notes

• Always append to gist-list.md, never overwrite
• Keep descriptions concise (under 80 characters)
• Include feature number if applicable
• Use current date in YYYY-MM-DD format
• Preview URL is the one to share (more readable than raw gist)