Chat Viewer for DeepSeek

A dual-interface tool for viewing DeepSeek chat conversation exports.

✨ Features
📱 Dual Interface

    Terminal CLI: Fast, keyboard-driven interface with ANSI colors
    Web Interface: Modern two-pane browser interface with real-time search

🔍 Smart Features

    Automatic merging: Loads multiple export files, keeps latest conversations
    Full-text search: Search across all conversations (titles and content)
    Fragments support: Proper handling of REQUEST/RESPONSE/THINK fragments
    Unicode support: Proper handling of emojis and international characters
    Color-coded display: Different colors for user/assistant/thinking messages

📊 Conversation Management

    Alphabetical sorting with letter grouping
    Conversation statistics (word count, message counts)
    Recency indicators (color-coded by age)

🚀 Quick Start
Prerequisites

    Go 1.16+ (for building from source)
    DeepSeek conversation exports (JSON format)

Installation

Option 1: Binary Download
Download the latest release for your platform from the Releases page.

Option 2: Build from Source
bash

git clone https://github.com/igormsc/chatviewer.git
cd chatviewer
go build -o chatviewer

📖 Usage
Basic Usage
bash

# Place your conversation JSON files in ./data
./cvds

# Or specify a different directory
./chatviewer /path/to/conversations

# Start with web interface
./chatviewer -web
./chatviewer -web -port 8080

CLI Interface
text

Available conversations (95):
────────────────────────────────────────────────────────────────────────────────
[A]
  1. Configuring Visual Studio Terminal Behavior
     ID: baafd1a | Updated: 2025-10-03 08:59 (green) | Messages: 5
  2. Another conversation...
     ID: c3d4e5f | Updated: 2025-10-02 14:30 (yellow) | Messages: 12

Enter conversation number, '/s' to search, '/q' to quit: 1

Web Interface

Start with ./chatviewer -web and open http://localhost:8888

    Left sidebar: Alphabetically sorted conversation list
    Right panel: Conversation display with color-coded fragments
    Click any conversation to view
    Press Escape to clear selection

Keyboard Shortcuts
CLI:

    [number] - Select conversation
    /s - Search mode
    /back - Return from search results
    /q - Quit

Web:

    Escape - Clear conversation selection
    Ctrl+F - Browser search (works on loaded conversations)

📝 Tips & Tricks
Exporting Conversations

    Use DeepSeek's export feature to get conversations.json
    Place josn files in ./data or any directory
    Run ./chatviewer

Search Syntax

    Searches are case-insensitive
    Title matches get higher priority
    Recent conversations appear first in results

🙏 Acknowledgments

    DeepSeek for the excellent AI and export format

🐛 Troubleshooting
Common Issues

"No conversations found"

    Check that JSON files are in correct directory
    Verify JSON format matches DeepSeek exports
    Ensure files have .json extension

Web interface not loading

    Check if port 8888 is already in use
    Verify -web flag is used
    Check browser console for errors

Colors not working in terminal

    Ensure terminal supports ANSI colors
    Check NO_COLOR environment variable isn't set
    Try FORCE_COLOR=1 ./chatviewer