Claude Notes

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.

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

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 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

Terminal Output

HTML Features

The HTML output includes:

- Message Navigation: Each message has a clickable heading with anchor links
- Humanized Timestamps: Shows when each message was created (e.g., "2 hours ago")
- Tool Result Formatting:
  - Bash commands with syntax highlighting
  - File operations (Read, Edit, MultiEdit)
  - Search results (Grep)
- Responsive Design: Works well on desktop and mobile
- Professional Styling: Clean, readable typography

How It…