Cursor Chat Browser

A web application for browsing and managing chat histories from the Cursor editor's AI chat feature. View, search, and export your AI conversations in various formats.

Features

• 🔍 Browse and search all workspaces with Cursor chat history
• 🤖 View both AI chat logs and Composer logs
• 📁 Organize chats by workspace
• 🔎 Full-text search with filters for chat/composer logs
• 📱 Responsive design with dark/light mode support
• ⬇️ Export chats as:
  • Markdown files
  • HTML documents (with syntax highlighting)
  • PDF documents
• 🎨 Syntax highlighted code blocks
• 📌 Bookmarkable chat URLs
• ⚙️ Automatic workspace path detection

Prerequisites

• Node.js 18+ and npm
• A Cursor editor installation with chat history

Installation

1. Clone the repository:

   git clone https://github.com/thomas-pedersen/cursor-chat-browser.git
   cd cursor-chat-browser

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open http://localhost:3000 in your browser

Configuration

The application automatically detects your Cursor workspace storage location based on your operating system:

• Windows: %APPDATA%\Cursor\User\workspaceStorage
• WSL2: /mnt/c/Users/<USERNAME>/AppData/Roaming/Cursor/User/workspaceStorage
• macOS: ~/Library/Application Support/Cursor/User/workspaceStorage
• Linux: ~/.config/Cursor/User/workspaceStorage

If automatic detection fails, you can manually set the path in the Configuration page (⚙️).

Usage

Browsing Logs

• View all workspaces on the home page
• Browse AI chat logs by workspace
• Access Composer logs from the navigation menu
• Navigate between different chat tabs within a workspace
• View combined logs with type indicators
• See chat and composer counts per workspace

Searching

• Use the search bar in the navigation to search across all logs
• Filter results by chat logs, composer logs, or both
• Search results show:
  • Type badge (Chat/Composer)
  • Matching text snippets
  • Workspace location
  • Title
  • Timestamp

Exporting

Each log can be exported as:

• Markdown: Plain text with code blocks
• HTML: Styled document with syntax highlighting
• PDF: Formatted document suitable for sharing

Development

Built with:

• Next.js 14 (App Router)
• TypeScript
• Tailwind CSS
• shadcn/ui components
• SQLite for reading Cursor's chat database

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Changelog

See CHANGELOG.md for a list of changes.

License

This project is licensed under the MIT License - see the LICENSE file for details.