shan
- Repo stars 330
- License MIT
- Author repo claude-skill-registry
- Domain
- Data
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @majiayu000 · MIT
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# 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__________________________`
```
Sections and files
Listed in source order.
sections -> Execute → Commands → transcript dump [session-id]
terms -> Arguments · Output · Examples · Output Format
files/cmd -> transcript dump [session-id] · [session-id] · dc8ffe42 · .claude/transcripts/<session-id>.transcript.md · 001 · 01/25/2026 22:45 · file-history-snapshot · snapshot______________________
body sha256 -> b8eb2a2ea956
Execute
Run the shan CLI with provided arguments:
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.mdin project directory