Cclog banner
annenpolka annenpolka

Cclog

Documentation community

Description

Convert Claude Code conversation to Markdown with TUI

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

cclog - Claude Code Conversation Log Viewer & Converter

Image

A Go command-line tool that parses Claude Code conversation logs (JSONL format), converts them to human-readable Markdown, and provides a powerful TUI to browse, manage, and interact with your logs.

Features

  • Powerful Interactive TUI Mode: A rich terminal interface to browse, preview, and manage your conversation logs.
    • Live Markdown Preview: Instantly preview how your .jsonl file will look in Markdown (p key).
    • Open in Editor: Convert and open logs directly in your default text editor with a single keypress (Enter key).
    • On-the-fly Filtering: Toggle message filters dynamically to switch between clean and raw views (s key).
    • Easy Navigation: Browse through directories and files with familiar keybindings.
    • Recursive File Search: Easily find all .jsonl logs within nested directories.
    • Session ID to Clipboard: Quickly copy a conversation's sessionId (from the filename) for other uses (c key).
    • claude CLI Integration: Resume conversations directly by launching the claude CLI (r key).
  • Flexible CLI Mode: Process files or entire directories directly from the command line for scripting and automation.
  • Clean Markdown Output: Converts conversations into a beautifully formatted, readable Markdown format.

Installation

# Install latest version from GitHub
go install github.com/annenpolka/cclog/cmd/cclog@latest

# Or build from source
go build -o cclog ./cmd/cclog/

# Run directly with Go
go run ./cmd/cclog/

Usage

cclog [OPTIONS] [input]

Arguments

  • [input] - Path to a JSONL file or a directory.
    • If no input is provided, cclog starts in TUI mode, recursively searching from ~/.claude/projects (if it exists), or the current directory.

Optio