Skip to content

Latest commit

 

History

History
105 lines (79 loc) · 2.87 KB

README.md

File metadata and controls

105 lines (79 loc) · 2.87 KB

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
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. 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.