Package Exports

ccscope
ccscope/src/CCScope.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ccscope) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CCScope 🔍

English | 日本語

Claude Code Scope - Interactive terminal browser for Claude Code conversation transcripts

Overview

CCScope (Claude Code Scope) is a powerful terminal-based application that allows you to browse, analyze, and explore your Claude Code conversation transcripts. It provides an intuitive interface for navigating through sessions, analyzing thinking patterns, response times, and tool usage.

Features

🔍 Interactive Browsing: Navigate through sessions and conversations with vim-like keybindings
📊 Rich Analytics: View response times and tool usage statistics
🔎 Full-text Search: Search across all conversations with highlighting, OR conditions, and regex support
🔄 Search-aware Navigation: Navigate through search results with left/right keys when viewing from search
🔎 Search & Filter: Find specific conversations or filter by project
📱 Responsive Design: Adapts to your terminal size with wide and compact layouts
⚡ Performance: Virtual scrolling and caching for large datasets
🔧 Tool Analysis: Detailed breakdown of tool usage and execution flow
💭 Thinking Process: View Claude's thinking patterns
📈 Session Metrics: Track conversation duration, response times, and productivity
🚀 Resume Sessions: Resume Claude Code sessions directly from CCScope with 'r' key

Screenshots

Session List View

🔍 Claude Code Scope
================================================================================
📊 35 Sessions | 💬 1503 Convos | ⏱️ 4d 9h 23m

▶ 1  52ccc342  ccscope               48 convos  1h 51m   07/10 23:52  07/12 19:58
  2  14208db7  sms-proto              7 convos  24m 24s   07/12 19:23  07/12 19:55
  3  7726f0    mobile-documents      40 convos   1h 6m   07/12 15:25  07/12 19:22

↑/↓ Navigate · Enter Details · r Resume · f Filter · s Sort · q Exit

Conversation Detail View

🔍 Claude Code Scope
================================================================================
💬 48 Convos | ⏱️ 1h 51m
Selected: [52ccc342] -Users-taguchiu-Documents-workspace-ccscope
📁 File: /Users/taguchiu/.claude/projects/...

▶ 1  07/10 14:30  12.3s  3t  Help me refactor ViewRenderer...
  2  07/10 14:35   8.7s  1t  Add full-width character support  
  3  07/10 14:42  15.2s  5t  Implement virtual scrolling

↑/↓ Select · Enter Detail · ←/→ Switch Session · r Resume · Esc Back

Full Detail View

[52ccc342] -Users-taguchiu-Documents-workspace-ccscope     [18-66/66] 100%
Conversation #15 of 48
================================================================================

👤 USER:
Help me refactor the ViewRenderer component...

🤖 ASSISTANT:
I'll help you refactor the ViewRenderer component...

🔧 Tools: Read×2, Edit×1

↑/↓ Scroll · Space Page · ←/→ Prev/Next · r Resume · g/G Top/Bottom · Esc Back

Installation

Global Installation (Recommended)

npm install -g ccscope

Once installed, you can run ccscope from anywhere in your terminal.

Quick Start

# Install globally
npm install -g ccscope

# Run CCScope
ccscope

# Or run without installation using npx
npx ccscope

# That's it! CCScope will automatically find your Claude Code transcripts

Local Installation

git clone https://github.com/taguchiu/ccscope.git
cd ccscope
npm install
npm link

Alternative Installation Methods

# Install from GitHub directly
npm install -g git+https://github.com/taguchiu/ccscope.git

# Install specific version
npm install -g ccscope@1.0.0

# Install locally for development
npm install ccscope

Usage

Basic Usage

# Interactive browser mode
ccscope

# Run with npx (no installation required)
npx ccscope

# Show statistics commands
ccscope daily            # Daily conversation statistics
ccscope project          # Project-grouped statistics
ccscope search "query"   # Search across all conversations

# Options
ccscope --help           # Show help
ccscope --debug          # Enable debug mode

# Search examples
ccscope search "error handling"
ccscope search "async await"
ccscope search "error OR warning"     # OR search (uppercase)
ccscope search "error or warning"     # OR search (lowercase)
ccscope search "function OR method"
ccscope search --regex "import.*from" # Regex search
ccscope search --regex "\berror\b"    # Word boundary search

# Combine commands with options
ccscope daily --debug
ccscope project --debug

Resume Claude Code Sessions

Press r in any view to resume a Claude Code session:

Automatically extracts the full session ID from transcript files
Changes to the project directory before resuming
Executes claude -r <session-id> to continue the conversation

This feature allows you to seamlessly continue conversations discovered through CCScope.

Session List View

↑/↓ or k/j: Navigate up/down
Enter: View session conversations
r: Resume session with claude -r
f: Filter by project
s: Sort sessions (last activity, duration, conversations, start time, project name)
/: Search sessions
h or ?: Show help
q: Exit

Conversation Detail View

↑/↓ or k/j: Navigate conversations
←/→ or h/l: Switch sessions
Enter: View full conversation detail
r: Resume session with claude -r
s: Sort conversations (date/time, duration, tools)
Esc: Back to session list

Full Detail View

↑/↓: Scroll content (5-line increments)
Space/b: Page up/down
g/G: Jump to top/bottom
←/→: Previous/next conversation (or navigate search results if from search)
r: Resume session with claude -r
Esc: Back to conversation list

Search Results View

↑/↓: Navigate search results
Enter: View conversation detail
Esc: Exit application

Keyboard Shortcuts

Key	Action
`q`	Quit application
`h` or `?`	Show help
`/`	Search
`f`	Filter
`s`	Sort
`r`	Resume session (claude -r)
`Esc`	Go back
`Enter`	Select/Enter

Configuration

CCScope automatically discovers Claude Code transcripts in these directories:

~/.claude/projects/
~/.config/claude/transcripts/
./transcripts/
./

Supported Formats

CCScope reads Claude Code transcript files in JSONL format (.jsonl extension).

Development

Project Structure

ccscope/
├── bin/                 # Executable scripts
│   └── ccscope         # Main CLI entry point
├── src/                # Source code
│   ├── config.js       # Configuration
│   ├── SessionManager.js
│   ├── StateManager.js
│   ├── ViewRenderer.js
│   ├── InputHandler.js
│   ├── ThemeManager.js
│   └── CCScope.js
├── CLAUDE.md           # Claude Code integration guide
├── examples/           # Example files
├── package.json
├── README.md
└── LICENSE

Architecture

CCScope follows a modular architecture:

CCScope: Main application orchestrator
SessionManager: Handles transcript discovery and parsing
StateManager: Manages application state and navigation
ViewRenderer: Handles UI rendering and display logic
InputHandler: Processes keyboard input and key bindings
ThemeManager: Manages color themes and text formatting

Building from Source

git clone https://github.com/taguchiu/ccscope.git
cd ccscope
npm install
npm start

Development Commands

# Run in development mode
npm run dev

# Start the application
npm start

# Make binary executable
chmod +x bin/ccscope

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

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

Support

Acknowledgments

Built for the Claude Code community
Inspired by terminal-based file browsers and analysis tools
Special thanks to all contributors and users

Made with ❤️ for Claude Code users

ccscope

Package Exports

Readme

CCScope 🔍

Overview

Features

Screenshots

Session List View

Conversation Detail View

Full Detail View

Installation

Global Installation (Recommended)

Quick Start

Local Installation

Alternative Installation Methods

Usage

Basic Usage

Resume Claude Code Sessions

Navigation

Session List View

Conversation Detail View

Full Detail View

Search Results View

Keyboard Shortcuts

Configuration

Supported Formats

Development

Project Structure

Architecture

Building from Source

Development Commands

Contributing

License

Support

Acknowledgments