# Shan

> Dump a Claude Code session transcript as navigable Markdown. Use when user wants to review, analyze, or export a session transcript.

- Skill: `majiayu000/shan` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/shan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/shan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/shan

---


# Shan

Claude Code tooling CLI (named after Claude Shannon).

## Execute

Run the shan CLI with provided arguments:

```bash
bun ~/projects/jasonkuhrt/dotfiles/packages/shan/src/bin/shan.ts $ARGUMENTS
```

## Commands

### `transcript dump [session-id]`

Convert JSONL transcripts to navigable Markdown with columnar headings for editor outline navigation.

**Arguments:**

| Argument | Description |
|----------|-------------|
| `[session-id]` | Optional. Partial UUID prefix (e.g., `dc8ffe42`). Defaults to current session. |

**Output:** `.claude/transcripts/<session-id>.transcript.md` in project directory

**Examples:**
```
/shan transcript dump              # dump current session
/shan transcript dump dc8ffe42     # dump specific session
```

**Output Format:**

Headings use monospace columns with underscore padding for editor outline alignment:

```markdown
# `001` `01/25/2026 22:45` `file-history-snapshot` `snapshot______________________`
# `002` `01/25/2026 22:45` `progress_____________` `SessionStart:clear____________`
# `003` `01/25/2026 22:46` `user_________________` `sync__________________________`
```