From 0a0bc65660f22d7442a41bf7ad52e5f244b8e403 Mon Sep 17 00:00:00 2001 From: d-kimsuon Date: Wed, 17 Sep 2025 23:32:20 +0900 Subject: [PATCH] docs: update README.md to clarify project focus as session log viewer MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Repositioned Claude Code Viewer as specialized session log analysis tool - Emphasized "lossless session log analysis" as core value proposition - Added "Alternatives & Differentiation" section acknowledging other excellent web clients - Highlighted unique features: zero data loss, progressive organization, built-in git diff viewer - Added "Built-in Development Tools" section detailing git and remote development features - Clarified positioning relative to general-purpose web clients 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- README.md | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 16f7fed..c1c680d 100644 --- a/README.md +++ b/README.md @@ -6,9 +6,9 @@ A full-featured web-based Claude Code client that provides complete interactive ## Overview -Claude Code Viewer has evolved from a simple conversation viewer into a comprehensive web-based Claude Code client. It provides all essential Claude Code functionality through an intuitive web interface, including creating new sessions, resuming conversations, real-time task management, and live synchronization with your local Claude Code projects. +Claude Code Viewer is a web-based Claude Code client focused on **lossless session log analysis**. It preserves and effectively organizes all conversation information through strict schema validation and progressive UI disclosure. -The application leverages Server-Sent Events (SSE) for real-time bidirectional communication, automatically syncing with JSONL conversation files in `~/.claude/projects/` and providing instant updates as conversations progress. +**Core Philosophy**: Zero data loss + Effective organization + Remote-friendly design ## Features @@ -36,6 +36,13 @@ The application leverages Server-Sent Events (SSE) for real-time bidirectional c - **Command Detection** - Enhanced display of XML-like command structures - **Task Controller** - Full lifecycle management of Claude processes +### Built-in Development Tools + +- **Git Diff Viewer** - Comprehensive branch comparison with file-by-file diff visualization +- **Remote Development Ready** - Full web-based access ideal for remote work and server environments +- **Branch & Commit Browser** - Navigate git history directly within the interface +- **Untracked File Support** - View diffs for untracked files alongside committed changes + ## Installation & Usage ### Quick Start (CLI) @@ -114,6 +121,23 @@ PORT=8080 npx @kimuson/claude-code-viewer@latest The application automatically detects the standard Claude Code directory at `~/.claude/projects/`. No additional configuration is required. +## Alternatives & Differentiation + +Several excellent Claude Code web clients exist, each with their own strengths: + +- https://github.com/sugyan/claude-code-webuisupport +- https://github.com/wbopan/cui +- https://github.com/siteboon/claudecodeui + +**Claude Code Viewer's Focus**: While these tools excel as general-purpose web clients, Claude Code Viewer specializes as a **session log viewer** with: + +- **Zero Information Loss**: Strict Zod schema validation preserves every conversation detail +- **Progressive Organization**: Expandable elements and sub-session modals manage information density +- **Built-in Git Diff Viewer**: Comprehensive branch comparison for remote development +- **Session Flow Analysis**: Complete conversation tracking across multiple sessions + +Each tool serves different use cases - choose the one that best fits your workflow and priorities. + ## License This project is available under the MIT License.