# 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.
```bash
uvx claude-notes show
```
https://github.com/user-attachments/assets/ca710fb3-558a-4ce5-9bf5-e42c80caf2bf
```bash
uvx claude-notes show --format html --output conversations.html
```
https://github.com/user-attachments/assets/e4cb9404-bdee-4a12-8e06-e1e2216b9165
## 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
```bash
# 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
```bash
# 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](CONTRIBUTING.md) for detailed guidelines.
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Support
- Report issues: [GitHub Issues](https://github.com/yourusername/claude-notes/issues)
- Feature requests: [GitHub Discussions](https://github.com/yourusername/claude-notes/discussions)
Raw data
{
"_id": null,
"home_page": null,
"name": "claude-notes",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai, claude, cli, html, terminal, transcript",
"author": "Claude Notes Contributors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/eb/0f/dc47f4dec5aad0593ea4244d4d28af8bb6f61ed6f4d97a7910680e6898a0/claude_notes-0.1.2.tar.gz",
"platform": null,
"description": "# Claude Notes\n\nTransform Claude Code transcript JSONL files into readable terminal and HTML formats.\n\n## Overview\n\nClaude 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.\n\n```bash\nuvx claude-notes show\n```\n\nhttps://github.com/user-attachments/assets/ca710fb3-558a-4ce5-9bf5-e42c80caf2bf\n\n```bash\nuvx claude-notes show --format html --output conversations.html\n```\n\nhttps://github.com/user-attachments/assets/e4cb9404-bdee-4a12-8e06-e1e2216b9165\n\n\n## Features\n\n- Terminal display with syntax highlighting and rich formatting\n- HTML export with navigation, timestamps, and professional styling\n- Interactive pager for browsing long conversations\n- Project discovery - automatically finds Claude projects\n- Humanized timestamps - shows \"2 hours ago\" instead of raw timestamps\n- Tool result formatting - properly displays Bash, Read, Edit, MultiEdit, and Grep tool usage\n- Navigation links - jump to specific messages in HTML output\n\n## Acknowledge\n\nThis tool was heavily inspired by https://github.com/daaain/claude-code-log\n\n## Usage\n\n#### HTML Output\n\n```bash\n# Export to HTML file\nuvx claude-notes show --format html --output conversations.html\n\n# Print HTML to stdout\nuvx claude-notes show --format html\n```\n\n#### Terminal Output\n\n```bash\n# View conversations for current directory\nuvx claude-notes show\n\n# View conversations for specific project path\nuvx claude-notes show /path/to/project\n\n# Disable pager (show all at once)\nuvx claude-notes show --no-pager\n\n# Show raw JSON data\nuvx claude-notes show --raw\n```\n\n## HTML Features\n\nThe HTML output includes:\n\n- **Message Navigation**: Each message has a clickable heading with anchor links\n- **Humanized Timestamps**: Shows when each message was created (e.g., \"2 hours ago\")\n- **Tool Result Formatting**: \n - Bash commands with syntax highlighting\n - File operations (Read, Edit, MultiEdit)\n - Search results (Grep)\n- **Responsive Design**: Works well on desktop and mobile\n- **Professional Styling**: Clean, readable typography\n\n## How It Works\n\nClaude Code stores conversation transcripts as JSONL files in `~/.claude/projects/`. Each line represents a message, tool use, or tool result. Claude Notes:\n\n1. Discovers Claude projects by scanning the projects directory\n2. Parses JSONL transcript files \n3. Groups related messages by role continuity\n4. Formats tool usage and results appropriately\n5. Outputs in your chosen format (terminal or HTML)\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Make your changes\n4. Test thoroughly\n5. Submit a pull request\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- Report issues: [GitHub Issues](https://github.com/yourusername/claude-notes/issues)\n- Feature requests: [GitHub Discussions](https://github.com/yourusername/claude-notes/discussions)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Transform Claude Code transcript JSONL files to terminal and HTML views",
"version": "0.1.2",
"project_urls": {
"Documentation": "https://github.com/yourusername/claude-notes#readme",
"Homepage": "https://github.com/yourusername/claude-notes",
"Issues": "https://github.com/yourusername/claude-notes/issues",
"Repository": "https://github.com/yourusername/claude-notes"
},
"split_keywords": [
"ai",
" claude",
" cli",
" html",
" terminal",
" transcript"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c22fc51c9a03de676087efeaefe7830bda6e15302f7343094a4695b7cc4da398",
"md5": "0b1a76115138cf30a993e2de628dc67b",
"sha256": "8e2dd707fba971e3164662188dcfc44bf9029e2e28d5e3c55fa589936030c349"
},
"downloads": -1,
"filename": "claude_notes-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0b1a76115138cf30a993e2de628dc67b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 34632,
"upload_time": "2025-08-21T07:33:59",
"upload_time_iso_8601": "2025-08-21T07:33:59.597592Z",
"url": "https://files.pythonhosted.org/packages/c2/2f/c51c9a03de676087efeaefe7830bda6e15302f7343094a4695b7cc4da398/claude_notes-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "eb0fdc47f4dec5aad0593ea4244d4d28af8bb6f61ed6f4d97a7910680e6898a0",
"md5": "ca0b001c4a71e1012e1b1813da154bb2",
"sha256": "b41130ccead9c40e1cb7f247f1b456175121e666a4f3f2be78b480989e5f84ef"
},
"downloads": -1,
"filename": "claude_notes-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "ca0b001c4a71e1012e1b1813da154bb2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 607514,
"upload_time": "2025-08-21T07:34:00",
"upload_time_iso_8601": "2025-08-21T07:34:00.858724Z",
"url": "https://files.pythonhosted.org/packages/eb/0f/dc47f4dec5aad0593ea4244d4d28af8bb6f61ed6f4d97a7910680e6898a0/claude_notes-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-21 07:34:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "claude-notes#readme",
"github_not_found": true,
"lcname": "claude-notes"
}
JSON
