cclog - Claude Code Log Browser

Browse and view Claude Code conversation history using fzf.

overview.mp4

The demo shows:

1. Opening the session list with cclog
2. Navigating through sessions with real-time preview
3. Resuming a Claude Code session with Ctrl-R

Installation

Using Sheldon (Recommended)

Add to your ~/.config/sheldon/plugins.toml:

[plugins.cclog]
github = "choplin/cclog"

Then run:

sheldon lock --update

Manual Installation (bash/zsh)

Works with both bash and zsh:

git clone https://github.com/choplin/cclog.git

Add to your shell configuration:

# For bash/zsh
source /path/to/cclog/cclog.sh

# For zsh with plugin managers (oh-my-zsh, etc)
# The cclog.plugin.zsh will be loaded automatically

Other Plugin Managers

Note: These methods haven't been tested but should work thanks to the standard .plugin.zsh file structure. Please open an issue if you encounter any problems!

Oh-My-Zsh

git clone https://github.com/choplin/cclog ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/cclog

Then add cclog to the plugins array in your ~/.zshrc:

plugins=(... cclog)

Zinit

zinit load choplin/cclog

Zplug

zplug "choplin/cclog"

Antigen

antigen bundle choplin/cclog

Zgen

zgen load choplin/cclog

Antibody

antibody bundle choplin/cclog

Usage

List sessions for current directory

cclog

Key bindings:

• Enter: Return the session ID
• Ctrl-V: View the full log in your pager
• Ctrl-P: Return the file path
• Ctrl-R: Resume the conversation with claude -r

List all projects

Browse all Claude Code projects sorted by recent activity:

cclog projects

Key bindings:

• Enter: Change directory to the selected project

The preview window shows the most recent sessions for each project, helping you quickly identify the project you're looking for.

View a specific session file

cclog view ~/.claude/projects/*/session-id.jsonl

Show session information

cclog info ~/.claude/projects/*/session-id.jsonl

Requirements

• fzf - Fuzzy finder
• python3 - Python 3.x (for performance optimization)
• claude - Claude Code CLI (for resume functionality)

Features

• Color-coded messages (User: Cyan, Assistant: White, Tool: Gray)
• Session information display (file, messages count, start time, duration)
• Interactive browsing with fzf
• Browse all projects across your system sorted by recent activity
• Resume conversations directly from the browser
• Performance optimized with Python helper script for large conversation histories
• Stream-based processing for efficient memory usage
• Duration and message count columns in the conversation list
• Topic summaries displayed when available (📑 prefix)

Testing

Run the test suite:

./run_tests.sh

Or manually with pytest:

pytest tests/ -v

License

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