{"id":48467076,"url":"https://github.com/kuaner/cc-reader","last_synced_at":"2026-04-21T04:04:03.442Z","repository":{"id":346729830,"uuid":"1191323633","full_name":"kuaner/cc-reader","owner":"kuaner","description":"A macOS app for reading and managing Claude Code session history.","archived":false,"fork":false,"pushed_at":"2026-04-07T03:19:48.000Z","size":17983,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-07T05:15:11.996Z","etag":null,"topics":["claude-code","jsonl","macos","swift","swiftui","xcodegen"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kuaner.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-25T06:02:51.000Z","updated_at":"2026-04-07T03:19:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kuaner/cc-reader","commit_stats":null,"previous_names":["kuaner/cc-reader"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/kuaner/cc-reader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuaner%2Fcc-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuaner%2Fcc-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuaner%2Fcc-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuaner%2Fcc-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kuaner","download_url":"https://codeload.github.com/kuaner/cc-reader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuaner%2Fcc-reader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31787263,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","jsonl","macos","swift","swiftui","xcodegen"],"created_at":"2026-04-07T05:01:02.956Z","updated_at":"2026-04-14T08:01:18.559Z","avatar_url":"https://github.com/kuaner.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cc-reader\n\n[English](README.md) | 日本語 | [简体中文](README.zh-Hans.md)\n\n[Claude Code](https://docs.anthropic.com/en/docs/claude-code) のセッション履歴を閲覧・管理するための macOS アプリ。\n\n`~/.claude/projects/` 配下の JSONL ファイルを監視し、会話タイムライン・思考プロセス・ツール使用状況をリッチな UI で表示します。\n\n![cc-reader demo](assets/screenshot.gif)\n\n\u003e **⚠️ 注意**\n\u003e これは**非公式**のサードパーティツールです。Claude Code の JSONL フォーマットは公開 API ではなく、予告なく変更される可能性があります。一部の管理操作はローカルのセッションファイルを変更する場合があります。バックアップを必ず保持してください。\n\n## 機能\n\n- **セッションリーダー** — Markdown レンダリング・シンタックスハイライト・コードブロック操作・メッセージ単位コピー対応の WKWebView タイムライン\n- **リアルタイム同期** — FSEvents でファイル変更を検出、差分パースで即座に反映\n- **セッション管理** — サイドバーからセッション名変更や削除が可能\n- **マルチペイン** — 最大12ペインで複数セッションを同時監視\n- **コンテキストパネル** — Claude の理解状況、読み込み/編集済みファイルを一覧表示\n- **長大タイムライン最適化** — ウィンドウ化レンダリング + 上端付近での過去メッセージ自動ロード\n\n## 必要環境\n\n- macOS 14.0+\n- Xcode 15.0+\n- [XcodeGen](https://github.com/yonaskolb/XcodeGen)\n\n## セットアップ\n\n```bash\n# XcodeGen が未インストールの場合\nbrew install xcodegen\n\n# クローンしてビルド\ngit clone https://github.com/kuaner/cc-reader.git\ncd cc-reader\nxcodegen\nopen CCReader.xcodeproj\n```\n\nXcode で `Cmd + R` でビルド＆実行。\n\n## ローカルビルドコマンド\n\nリポジトリ直下の [Makefile](Makefile) で、ローカルビルド・universal バイナリ生成・パッケージングをまとめて実行できます。\n\n```bash\n# Xcode プロジェクトを生成\nmake gen\n\n# universal Debug / Release アプリをビルド\nmake debug\nmake release\n\n# ビルド済みアプリを起動\nmake run CONFIG=Release\n\n# Release を DMG にパッケージ\nmake dmg\n```\n\nデフォルトの出力先:\n\n- App bundle: `build/DerivedData/Build/Products/Release/CC Reader.app`\n- DMG: `build/cc-reader.dmg`\n\nMakefile はデフォルトで universal macOS バイナリ（`arm64` + `x86_64`）を生成します。\n\n## リリースフロー\n\nバージョン更新とタグ作成はローカルの Makefile で行います。\n\n```bash\n# project.yml の MARKETING_VERSION を更新\nmake version VERSION=1.0.0 BUILD_NUMBER=2\n\n# バージョン更新、リリースコミット作成、v1.0.0 タグ作成\nmake release-tag VERSION=1.0.0 BUILD_NUMBER=2\n\n# 上記に加えてブランチとタグを GitHub に push\nmake publish VERSION=1.0.0 BUILD_NUMBER=2\n```\n\n`make publish` で release tag を GitHub に push すると、GitHub Actions が universal Release アプリをビルドし、DMG を生成して GitHub Releases にアップロードします。\n\n## Swift Package (CCReaderKit)\n\ncc-reader は Swift Package として他の macOS アプリに組み込むこともできます。\n\n### 依存関係を追加\n\nXcode で：**File → Add Package Dependencies…** → リポジトリ URL を入力：\n\n```\nhttps://github.com/kuaner/cc-reader.git\n```\n\nまたは `Package.swift` に追加：\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/kuaner/cc-reader.git\", from: \"0.1.0\"),\n]\n```\n\nターゲットに `CCReaderKit` を追加：\n\n```swift\n.target(\n    name: \"YourApp\",\n    dependencies: [\n        .product(name: \"CCReaderKit\", package: \"cc-reader\"),\n    ]\n)\n```\n\n### 使い方\n\n#### クイックスタート — 独立ウィンドウ\n\n最もシンプルな方法、1行で CC Reader を開けます：\n\n```swift\nimport CCReaderKit\n\nCCReaderKit.open()\n```\n\nウィンドウはシングルトンとして管理され、再度呼び出すと既存のウィンドウが再利用されます。\n\n#### フルインテグレーション — NSWindow + Toolbar\n\nウィンドウのライフサイクルを完全に制御する必要があるアプリ（メニューバーアプリなど）では、`CCReaderKit.makeView()` を使って `NSWindow` を自分で作成・管理します：\n\n```swift\nimport SwiftUI\nimport CCReaderKit\n\nclass AppDelegate: NSObject, NSApplicationDelegate {\n    private var readerWindow: NSWindow?\n\n    func openReader() {\n        if readerWindow == nil {\n            let readerView = CCReaderKit.makeView()\n            readerWindow = NSWindow(\n                contentRect: NSRect(x: 0, y: 0, width: 1200, height: 800),\n                styleMask: [.titled, .closable, .miniaturizable, .resizable, .fullSizeContentView],\n                backing: .buffered,\n                defer: false\n            )\n            readerWindow?.title = \"CC Reader\"\n\n            // 必須：NSToolbar + .unified スタイルにより、SwiftUI の toolbar items\n            //（パス、Resume、更新ボタン）がタイトルバーに表示されます。\n            let toolbar = NSToolbar(identifier: \"CCReaderToolbar\")\n            toolbar.displayMode = .iconOnly\n            readerWindow?.toolbar = toolbar\n            readerWindow?.toolbarStyle = .unified\n\n            readerWindow?.contentViewController = NSHostingController(rootView: readerView)\n            readerWindow?.setContentSize(NSSize(width: 1200, height: 800))\n            readerWindow?.center()\n            readerWindow?.isReleasedWhenClosed = false\n        }\n        readerWindow?.makeKeyAndOrderFront(nil)\n    }\n}\n```\n\n\u003e **ポイント：**\n\u003e - SwiftUI の toolbar を正しくブリッジするには、`NSHostingView` ではなく `NSHostingController` を使用してください。\n\u003e - `NSToolbar` を追加し `.unified` スタイルを設定すると、toolbar items がタイトルバーに表示されます。\n\u003e - `styleMask` に `.fullSizeContentView` を含めると、`NavigationSplitView` のレイアウトが正しく動作します。\n\u003e - `isReleasedWhenClosed = false` を設定してウィンドウインスタンスを再利用してください。\n\n\u003e macOS 14.0+ が必要です。marked.js、highlight.js、ローカライズリソースはパッケージに同梱されています。\n\n## 技術スタック\n\n| カテゴリ | 技術 |\n|---------|------|\n| UI | SwiftUI + WKWebView（Timeline） |\n| 永続化 | SwiftData |\n| ファイル監視 | FSEvents |\n| Web レンダリング | marked.js + highlight.js（バンドル） |\n| ビルド | XcodeGen (`project.yml`) |\n\n## アーキテクチャ\n\n```\nデータソース: ~/.claude/projects/**/*.jsonl\n    ↓ FSEvents\nFileWatcherService → SyncService → JSONLParser（差分パース）\n    ↓\nSwiftData ModelContext\n    ↓\nSessionMessagesView（スナップショット構築）\n    ↓\nTimelineHostView（単一 WKWebView / ウィンドウ化レンダリング）\n```\n\n詳細は [docs/SPEC.md](docs/SPEC.md) を参照。\n\n## ドキュメント\n\n- [Architecture \u0026 Specification](docs/SPEC.md)\n\n## 謝辞\n\n[Mutafika/Opuswap](https://github.com/Mutafika/Opuswap) から fork したリポジトリです（MIT License）。\n\n## ライセンス\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuaner%2Fcc-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkuaner%2Fcc-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuaner%2Fcc-reader/lists"}