/export — Session Export | pds | ClaudePluginHub

Skill

/export — Session Export

From pds

Exports Claude Code session JSONL files to human-readable markdown with role markers and timestamps. Use to save, review, share transcripts, or feed dev-diary pipelines.

developer-tools

$

npx claudepluginhub rmzi/portable-dev-system --plugin pds

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Export Claude Code session JSONL files to human-readable markdown.

SKILL.md

Similar Skills

export-session-as-markdown

159

Exports Claude Code session transcripts to GitHub-flavored Markdown with metadata header, collapsible tool results, and thinking blocks. Invoke via /export-session-as-markdown for current or specified path.

ed3d-session-reflection

prompt-log

586

Extracts markdown transcripts from Clawdbot, Claude Code, and Codex .jsonl session logs using a bash script with jq. Useful for exporting prompt history or AI coding session transcripts.

sundial-org-awesome-openclaw-skills-4

session-share

2.2k

Export and import Claude Code sessions to JSON files for secure, private sharing between developers via direct file transfer.

3 files

asheshgoplani-agent-deck

Stats

Stars19

Forks0

Last CommitApr 23, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

markdown-export

Help us improve

Share bugs, ideas, or general feedback.

/export — Session Export

Export Claude Code session JSONL files to human-readable markdown.

Output also feeds the dev-diary pipeline in /pds:finish — scripts/assemble-diary.sh calls export-session.sh to produce the raw transcript block that lives inside the diary comment's <details> wrapper.

Usage

Run the export script:

# Export current/latest session to stdout
scripts/export-session.sh

# Export specific session
scripts/export-session.sh <session-id>

# Save to file
scripts/export-session.sh -o docs/conversations/session-name.md

# List available sessions
scripts/export-session.sh --list

Env var overrides

Var	Purpose
`TRANSCRIPT_PATH`	Absolute path to the JSONL. Skips CWD-hash session discovery entirely — canonical source is the `transcript_path` field in hook payloads.
`FILTER_BRANCH`	If set, JSONL entries are filtered to those whose `gitBranch` matches (entries without `gitBranch`, like early-session system messages, pass through). Produces a tighter, branch-scoped transcript.

Or from the plugin root:

$CLAUDE_PLUGIN_ROOT/scripts/export-session.sh

Output Format

The exported markdown uses role markers for readability:

Marker	Role
👤 Human	User messages
🔵 Claude	Assistant text + tool calls
🤖 Agent	Teammate/subagent messages
⚙️ System	Slash commands
⚙️ Shell	Terminal commands run by user

Tool calls appear as compact 📎 lines showing the tool name and key parameters.

Timestamps are shown on every message. System reminders, XML tags, and internal metadata are stripped for readability.

Where Sessions Live

Session JSONL files are stored at:

~/.claude/projects/<project-hash>/<session-id>.jsonl

Each project directory corresponds to a working directory. Use --list to see available sessions with their sizes and dates.

When to Use

After a significant session to preserve the decision trail
Before closing a session that explored important design decisions
To share session context with teammates
For retrospective analysis of how a swarm executed

Conventions

Save exported sessions to docs/conversations/ with descriptive names:

docs/conversations/2026-04-02-v4.8.0-session.md
docs/conversations/2026-03-31-source-analysis.md

See Also

scripts/efficiency-chart.sh — Value stream visualization from telemetry