Claude Notes — Development skill for Claude Code

Claude Notes

Transform Claude Code transcript JSONL files into readable terminal and HTML formats.

Overview

Claude Notes is a command-line tool that converts Claude Code conversation transcripts (stored as JSONL files) into human-readable formats. It supports both terminal output with rich formatting and HTML export for web viewing.

uvx claude-notes show --format html --output conversations.html

https://github.com/user-attachments/assets/f24d143d-cb47-495a-b1f8-3e85863e5846

uvx claude-notes show

https://github.com/user-attachments/assets/ca710fb3-558a-4ce5-9bf5-e42c80caf2bf

Examples

See rendered HTML output examples:

• Conversation Export - Full conversation with tool usage, code blocks, and timestamps

The `examples/` directory also contains a [dark theme CSS](examples/example-dark-style.css) you can use to customize the HTML output.

Features

• Terminal display with syntax highlighting and rich formatting
• HTML export with navigation, timestamps, and professional styling
• Interactive pager for browsing long conversations
• Project discovery - automatically finds Claude projects
• Humanized timestamps - shows "2 hours ago" instead of raw timestamps
• Tool result formatting - properly displays Bash, Read, Edit, MultiEdit, and Grep tool usage
• Navigation links - jump to specific messages in HTML output

Acknowledge

This tool was heavily inspired by https://github.com/daaain/claude-code-log

Usage

HTML Output

# Export to HTML file
uvx claude-notes show --format html --output conversations.html

# Print HTML to stdout
uvx claude-notes show --format html

Terminal Output

# View conversations for current direc