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

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

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

https://github.com/user-attachments/assets/e4cb9404-bdee-4a12-8e06-e1e2216b9165

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

# 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 directory
uvx claude-notes show

# View conversations for specific project path
uvx claude-notes show /path/to/project

# Disable pager (show all at once)
uvx claude-notes show --no-pager

# Show raw JSON data
uvx claude-notes show --raw

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 Works

Claude Code stores conversation transcripts as JSONL files in ~/.claude/projects/. Each line represents a message, tool use, or tool result. Claude Notes:

1. Discovers Claude projects by scanning the projects directory
2. Parses JSONL transcript files
3. Groups related messages by role continuity
4. Formats tool usage and results appropriately
5. Outputs in your chosen format (terminal or HTML)

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes
4. Test thoroughly
5. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

License

MIT License - see LICENSE file for details.

Support

• Report issues: GitHub Issues
• Feature requests: GitHub Discussions