https://github.com/lvncer/cclog
TypeScript で実装された Claude Code 会話履歴ブラウザーのNPMパッケージ
https://github.com/lvncer/cclog
claude-code
Last synced: 30 days ago
JSON representation
TypeScript で実装された Claude Code 会話履歴ブラウザーのNPMパッケージ
- Host: GitHub
- URL: https://github.com/lvncer/cclog
- Owner: lvncer
- License: mit
- Created: 2025-07-12T02:44:08.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-07-13T16:07:22.000Z (7 months ago)
- Last Synced: 2025-09-15T01:46:35.817Z (5 months ago)
- Topics: claude-code
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/@lvncer/cclog
- Size: 279 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cclog
TypeScript で実装された Claude Code 会話履歴ブラウザー
[](https://badge.fury.io/js/%40lvncer%2Fcclog)
[](https://opensource.org/licenses/MIT)
## 📖 概要
cclog は、Claude Code の会話履歴をコマンドライン上で効率的に閲覧・管理するためのツールです。インタラクティブなセレクターを使用して、過去のセッションを簡単に検索、閲覧、再開できます。
## ✨ 主な機能
- 🔍 **セッション一覧表示** - 現在のディレクトリの Claude Code セッションを一覧
- 📁 **プロジェクト一覧表示** - 全プロジェクトを最新活動順で表示
- 👀 **セッション内容表示** - 色分けされたメッセージ表示
- ℹ️ **セッション情報表示** - 詳細なセッション情報
- 🎯 **インタラクティブセレクター** - fzf 風の直感的な操作
- 🎨 **カラー出力** - 見やすい色分け表示
- 🔄 **セッション再開** - ワンクリックでセッションを再開
## 🚀 インストール
```bash
npm install -g @lvncer/cclog
```
## 📖 使い方
### 基本的な使い方
```bash
# セッション一覧を表示（現在のディレクトリ）
cclog
# プロジェクト一覧を表示
cclog projects
# セッション内容を表示
cclog view /path/to/session.jsonl
# セッション情報を表示
cclog info /path/to/session.jsonl
# ヘルプを表示
cclog help
```
### キーボード操作
#### ナビゲーション
- `↑↓` - 上下に移動
- `Enter` - 選択
- `Ctrl+C` - 終了
- 文字入力 - リアルタイム検索
- `Backspace` - 検索文字削除
#### セッション一覧での操作
- `Enter` - セッション ID を返す
- `Ctrl+V` - セッション内容を表示
- `Ctrl+P` - ファイルパスを返す
- `Ctrl+R` - セッションを再開（claude -r）
#### プロジェクト一覧での操作
- `Enter` - プロジェクトディレクトリに移動
- `Ctrl+P` - プロジェクトパスを返す
- `Ctrl+S` - プロジェクトのセッション一覧表示
- `Ctrl+F` - セッションファイル名一覧表示
## 🎯 使用例
### 1. セッション一覧から選択
```bash
cclog
```
### 2. セッションを再開
セッションを選択して `Ctrl+R` を押すと、そのセッションが Claude Code で再開されます。
### 3. プロジェクト間を移動
```sh
cclog projects
```
## 🔄 操作フロー
### メインフロー図
```mermaid
flowchart TD
A[ユーザーが cclog コマンド実行] --> B{コマンド選択}
B -->|cclog| C[現在プロジェクトのセッション一覧]
B -->|cclog projects| D[全プロジェクト一覧]
B -->|cclog view | E[セッション内容表示]
B -->|cclog info | F[セッション情報表示]
B -->|cclog help| G[ヘルプ表示]
C --> H[セッション選択画面]
D --> I[プロジェクト選択画面]
H --> J{キー操作}
I --> K{キー操作}
J -->|Enter| L[セッションIDを返す]
J -->|Ctrl+V| M[セッション内容を表示]
J -->|Ctrl+P| N[ファイルパスを返す]
J -->|Ctrl+R| O[claude -r でセッション再開]
J -->|Ctrl+C| P[終了]
K -->|Enter| Q[プロジェクトディレクトリに移動]
K -->|Ctrl+P| R[プロジェクトパスを返す]
K -->|Ctrl+S| S[プロジェクトのセッション一覧表示]
K -->|Ctrl+F| T[セッションファイル名一覧表示]
K -->|Ctrl+C| P
S --> U[プロジェクトセッション選択画面]
T --> V[ファイル名一覧表示]
U --> W{キー操作}
W -->|Enter| X[セッションIDを返す]
W -->|Ctrl+V| Y[セッション内容を表示]
W -->|Ctrl+P| Z[ファイルパスを返す]
W -->|Ctrl+C| P
```
詳細な操作フローについては [docs/user-actions-flow.md](docs/user-actions-flow.md) をご覧ください。
## 🔧 開発者向け
### ローカル開発
```bash
# リポジトリをクローン
git clone
cd cclog
# 依存関係をインストール
npm install
# TypeScriptをコンパイル
npm run build
# 開発モードで実行（npm または bun）
npm run dev
bun run dev projects
```
### ファイル構成
```sh
src/
├── types/ # 型定義
├── core/ # コア機能
├── ui/ # UI機能
└── index.ts # メインエントリー
```
## ⚠️ 注意事項
- **Claude Code** が `~/.claude/projects/` にデータを保存している必要があります
- **Node.js 14 以上** が必要です
- **Unix 系 OS**（macOS、Linux）で動作確認済み
- セッション再開機能には **`claude` CLI** がインストールされている必要があります
## 🤝 貢献
バグ報告や機能要望は [Issues](https://github.com/lvncer/cclog/issues) までお気軽にどうぞ。
## 📄 ライセンス
MIT License - 詳細は [LICENSE](LICENSE) ファイルをご覧ください。
## 🙏 クレジット
このプロジェクトは [@choplin](https://github.com/choplin) 氏の [cclog](https://github.com/choplin/cclog) を参考にしています。