docs: update README.md to clarify project focus as session log viewer

- 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 <noreply@anthropic.com>
This commit is contained in:
d-kimsuon
2025-09-17 23:32:20 +09:00
parent 50e7346eb1
commit 0a0bc65660

View File

@@ -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.