# Smts Export

> Export the current Claude Code session as a solarized-light themed HTML page

- Skill: `christophe1997/smts-export` (Agent Skill)
- Install (CLI): `npx skillmds@latest add christophe1997/smts-export`
- Raw SKILL.md: https://api.skillmd.com/api/skills/christophe1997/smts-export/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: Christophe1997 (https://skillmd.com/u/christophe1997)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/christophe1997/smts-export

---


Export the current Claude Code session transcript to a single self-contained HTML file with a solarized-light theme, then open it in the browser.

## CLI Options

| Flag | Description |
|------|-------------|
| `pick` | Choose from recent sessions instead of auto-detecting |
| `-o, --output PATH` | Custom output path (file or directory for split mode) |
| `--split` | Split large sessions into multiple HTML files with index |
| `--page-size N` | Messages per page when splitting (default: 50) |

## Process

1. **Parse arguments**: Extract any flags from the user's input:
   - Look for `-o` or `--output` followed by a path
   - Look for `--split` flag
   - Look for `--page-size` followed by a number
   - Check for `pick` keyword

2. **Determine the session file**:

   If `pick` was specified:
   - Run the session lister script scoped to the current project, showing the last 5 sessions:
     ```bash
     python3 "${CLAUDE_PLUGIN_ROOT}/scripts/list-sessions.py" --project "${SMTS_PROJECT_DIR:-$(pwd)}" --limit 5
     ```
   - Each output line is tab-separated: `date \t first-message \t session-id(short) \t /full/path`
   - Use AskUserQuestion to present each session as `[date] session-id(short): first message…`
   - From the chosen entry:
     - Take the last tab field as `SESSION_FILE` (full path)
     - Extract the full session ID from the filename: `SESSION_ID=$(basename "$SESSION_FILE" .jsonl)`
     - Extract the project directory from the path (parent directory of the session file)

   Otherwise (default: auto-detect current session):
   - **Locate the session file**:
     ```bash
     # Convert cwd to the project directory slug
     # e.g., /Users/user/code/myproject -> -Users-user-code-myproject
     PROJECT_DIR=$(echo "${SMTS_PROJECT_DIR:-$(pwd)}" | sed 's|^/||; s|/|-|g' | sed 's|^|-|')

     # Try the session ID captured at session start (set by SessionStart hook)
     SESSION_ID="${SMTS_SESSION_ID:-}"
     if [ -n "$SESSION_ID" ]; then
       SESSION_FILE=$(ls ~/.claude/projects/${PROJECT_DIR}/${SESSION_ID}.jsonl 2>/dev/null | head -1)
     fi

     # Fallback: most recently modified non-agent JSONL in the project directory
     if [ -z "${SESSION_FILE:-}" ]; then
       SESSION_FILE=$(ls -t ~/.claude/projects/${PROJECT_DIR}/*.jsonl 2>/dev/null | grep -v '/agent-' | head -1)
     fi
     ```

3. **Determine output path**:

   If `-o` was specified:
   - Use the provided path

   Otherwise:
   - Default output directory: `docs/sessions/` (create if needed)
   - Default filename: `<full-session-id>.html` (or `<full-session-id>-pages/` for split mode)
   - The full session ID is the complete UUID (e.g., `12c5520e-5003-423a-b494-15eb204b4572`)
   - Ask user: "Export session to `docs/sessions/<full-session-id>.html`? [Y/n]"

4. **Check message count and suggest split for large sessions**:

   Count messages in the session:
   ```bash
   wc -l "$SESSION_FILE"
   ```

   If message count > 100 and `--split` was NOT specified:
   - Ask user: "This session has X messages. Split into multiple pages for easier viewing? [y/N]"
   - If yes, enable split mode

5. **Generate the HTML**:

   For single HTML:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/generate-html.py" "$SESSION_FILE" -o "$OUTPUT_PATH"
   ```

   For split HTML:
   ```bash
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/generate-html.py" "$SESSION_FILE" -o "$OUTPUT_DIR" --split --page-size "$PAGE_SIZE"
   ```

6. **Open in browser**:
   ```bash
   open "$OUTPUT_PATH"  # or open "$OUTPUT_DIR/index.html" for split mode
   ```

7. **Report to user**: Tell them the output path and that it's been opened in their browser.

## Important Notes

- The generated HTML is fully self-contained (inline CSS + JS, no external dependencies)
- Uses the Solarized Light color scheme for comfortable reading
- All content blocks are rendered: user messages, assistant text, thinking (collapsible), tool calls, tool results
- Long content sections are truncatable with "Show more" buttons
- Split mode creates keyboard navigation (arrow keys) between pages
- Timestamps are converted to local time via JavaScript