@kimuson/claude-code-viewer 0.0.1

package/README.md

@@ -0,0 +1,126 @@
+# Claude Code Viewer
+
+A web-based viewer for browsing Claude Code conversation history files. View and navigate your Claude Code project conversations through a clean, intuitive interface.
+
+## Overview
+
+Claude Code Viewer parses JSONL conversation files stored in `~/.claude/projects/` and presents them in a human-readable web UI. Browse projects, sessions, and detailed conversation history with support for tool usage, subtasks, and real-time file monitoring.
+
+## Features
+
+- **Project Browser** - View all Claude Code projects with metadata and session counts
+- **Session Navigation** - Browse conversation sessions within projects with filtering options
+- **Conversation Display** - Human-readable format for Claude Code logs with syntax highlighting
+- **Subtask Support** - Separate display for subtasks and sidechain conversations
+- **Real-time Updates** - Automatic refresh when conversation files are modified
+- **File System Watching** - Monitors `~/.claude/projects/` for changes and updates the UI
+- **Responsive Design** - Works on desktop and mobile devices
+
+## Installation & Usage
+
+### Quick Start
+
+Run directly from GitHub without installation:
+
+```bash
+PORT=3400 npx github:d-kimuson/claude-code-viewer
+```
+
+The server will start on port 3400 (or the specified PORT). Open `http://localhost:3400` in your browser.
+
+### Alternative Installation
+
+Clone and run locally:
+
+```bash
+git clone https://github.com/d-kimuson/claude-code-viewer.git
+cd claude-code-viewer
+pnpm i
+pnpm build
+pnpm start
+```
+
+## Requirements
+
+- **Node.js** 18 or later
+- **Claude Code** with conversation history in `~/.claude/projects/`
+
+## Data Source
+
+The application reads Claude Code conversation files from:
+
+- **Location**: `~/.claude/projects/<project>/<session-id>.jsonl`
+- **Format**: JSONL files containing conversation entries
+- **Auto-detection**: Automatically discovers new projects and sessions
+
+## Usage Guide
+
+### 1. Project List
+
+- Browse all Claude Code projects
+- View project metadata (name, path, session count, last modified)
+- Click any project to view its sessions
+
+### 2. Session Browser  
+
+- View all conversation sessions within a project
+- Filter to hide empty sessions
+- Sessions show message counts and timestamps
+- Click to view detailed conversation
+
+### 3. Conversation Viewer
+
+- Full conversation history with proper formatting
+- Syntax highlighting for code blocks
+- Tool usage and results clearly displayed
+- Navigation sidebar for jumping between sessions
+- Support for different message types (user, assistant, system, tools)
+
+## Configuration
+
+### Port Configuration
+
+Set a custom port using the `PORT` environment variable:
+
+```bash
+PORT=8080 npx github:d-kimuson/claude-code-viewer
+```
+
+### Data Directory
+
+The application automatically detects the standard Claude Code directory at `~/.claude/projects/`. No additional configuration is required.
+
+## Browser Support
+
+- Chrome/Chromium 90+
+- Firefox 88+
+- Safari 14+
+- Edge 90+
+
+## Troubleshooting
+
+### No Projects Found
+
+- Ensure Claude Code has been used and has created conversation files
+- Check that `~/.claude/projects/` exists and contains project directories
+- Verify file permissions allow reading the projects directory
+
+### Connection Issues
+
+- Check that the specified port is not in use
+- Ensure firewall settings allow local connections
+- Try a different port using the `PORT` environment variable
+
+### Real-time Updates Not Working
+
+- The application uses Server-Sent Events for real-time updates
+- Some browsers or network configurations may block SSE connections
+- Refresh the page manually to see latest changes
+
+## License
+
+This project is available under the MIT License. See the LICENSE file for details.
+
+## Contributing
+
+See [docs/dev.md](docs/dev.md) for development setup and contribution guidelines.

package/dist/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+await import("./standalone/server.js").catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/dist/standalone/.next/BUILD_ID

@@ -0,0 +1 @@
+-bAyRz7I7Uct3-uKwsaVj

package/dist/standalone/.next/app-build-manifest.json

@@ -0,0 +1,63 @@
+{
+  "pages": {
+    "/_not-found/page": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/2c913ea3-36aa7bd637622470.js",
+      "static/chunks/341-8b4909db05986cae.js",
+      "static/chunks/main-app-0ebf83e8ce07651b.js",
+      "static/chunks/app/_not-found/page-2b111b86d54b32e3.js"
+    ],
+    "/layout": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/2c913ea3-36aa7bd637622470.js",
+      "static/chunks/341-8b4909db05986cae.js",
+      "static/chunks/main-app-0ebf83e8ce07651b.js",
+      "static/css/6e09e605dcaa88b1.css",
+      "static/chunks/449-c035709aa8092b3b.js",
+      "static/chunks/app/layout-ea51e88a137c433d.js"
+    ],
+    "/api/[[...route]]/route": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/2c913ea3-36aa7bd637622470.js",
+      "static/chunks/341-8b4909db05986cae.js",
+      "static/chunks/main-app-0ebf83e8ce07651b.js",
+      "static/chunks/app/api/[[...route]]/route-065b2b751f08088c.js"
+    ],
+    "/page": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/2c913ea3-36aa7bd637622470.js",
+      "static/chunks/341-8b4909db05986cae.js",
+      "static/chunks/main-app-0ebf83e8ce07651b.js",
+      "static/chunks/app/page-065b2b751f08088c.js"
+    ],
+    "/projects/[projectId]/page": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/2c913ea3-36aa7bd637622470.js",
+      "static/chunks/341-8b4909db05986cae.js",
+      "static/chunks/main-app-0ebf83e8ce07651b.js",
+      "static/chunks/449-c035709aa8092b3b.js",
+      "static/chunks/771-7ade401d2bcf557c.js",
+      "static/chunks/655-a32d6fd8f19448f0.js",
+      "static/chunks/app/projects/[projectId]/page-cb0896b46dfbb71a.js"
+    ],
+    "/projects/page": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/2c913ea3-36aa7bd637622470.js",
+      "static/chunks/341-8b4909db05986cae.js",
+      "static/chunks/main-app-0ebf83e8ce07651b.js",
+      "static/chunks/449-c035709aa8092b3b.js",
+      "static/chunks/771-7ade401d2bcf557c.js",
+      "static/chunks/app/projects/page-699c53d41e9dfd5b.js"
+    ],
+    "/projects/[projectId]/sessions/[sessionId]/page": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/2c913ea3-36aa7bd637622470.js",
+      "static/chunks/341-8b4909db05986cae.js",
+      "static/chunks/main-app-0ebf83e8ce07651b.js",
+      "static/chunks/449-c035709aa8092b3b.js",
+      "static/chunks/771-7ade401d2bcf557c.js",
+      "static/chunks/889-c0fb777d081684b2.js",
+      "static/chunks/app/projects/[projectId]/sessions/[sessionId]/page-80afc861d53d73a3.js"
+    ]
+  }
+}

package/dist/standalone/.next/app-path-routes-manifest.json

@@ -0,0 +1,8 @@
+{
+  "/_not-found/page": "/_not-found",
+  "/api/[[...route]]/route": "/api/[[...route]]",
+  "/page": "/",
+  "/projects/[projectId]/page": "/projects/[projectId]",
+  "/projects/page": "/projects",
+  "/projects/[projectId]/sessions/[sessionId]/page": "/projects/[projectId]/sessions/[sessionId]"
+}

package/dist/standalone/.next/build-manifest.json

@@ -0,0 +1,33 @@
+{
+  "polyfillFiles": [
+    "static/chunks/polyfills-42372ed130431b0a.js"
+  ],
+  "devFiles": [],
+  "ampDevFiles": [],
+  "lowPriorityFiles": [
+    "static/-bAyRz7I7Uct3-uKwsaVj/_buildManifest.js",
+    "static/-bAyRz7I7Uct3-uKwsaVj/_ssgManifest.js"
+  ],
+  "rootMainFiles": [
+    "static/chunks/webpack-37af2f5780141d68.js",
+    "static/chunks/2c913ea3-36aa7bd637622470.js",
+    "static/chunks/341-8b4909db05986cae.js",
+    "static/chunks/main-app-0ebf83e8ce07651b.js"
+  ],
+  "rootMainFilesTree": {},
+  "pages": {
+    "/_app": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/framework-a164f82cd8755073.js",
+      "static/chunks/main-fa0c4fdedaf16ad5.js",
+      "static/chunks/pages/_app-9df37aca1cc9efd0.js"
+    ],
+    "/_error": [
+      "static/chunks/webpack-37af2f5780141d68.js",
+      "static/chunks/framework-a164f82cd8755073.js",
+      "static/chunks/main-fa0c4fdedaf16ad5.js",
+      "static/chunks/pages/_error-7c44112af45da2e9.js"
+    ]
+  },
+  "ampFirstPages": []
+}

package/dist/standalone/.next/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/dist/standalone/.next/prerender-manifest.json

@@ -0,0 +1,61 @@
+{
+  "version": 4,
+  "routes": {
+    "/_not-found": {
+      "initialStatus": 404,
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/_not-found",
+      "dataRoute": "/_not-found.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/": {
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/",
+      "dataRoute": "/index.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    }
+  },
+  "dynamicRoutes": {},
+  "notFoundRoutes": [],
+  "preview": {
+    "previewModeId": "306b502f6c883a93e25d563ae506eb07",
+    "previewModeSigningKey": "c3a648f53335250803402f05ca56c4e6d6931efcab1942337a0f049fdb22aeff",
+    "previewModeEncryptionKey": "b1a96b185eb198fb8258ac344083272b7fcf7bd3718d890fe16096df031d716f"
+  }
+}