Claude Code Viewer is a web-based client designed to provide a comprehensive, interactive experience for managing Claude Code projects. It caters to users and developers working with Claude Code, offering a modern interface for creating new conversations, resuming existing sessions, monitoring tasks in real-time, and browsing conversation history, thereby streamlining project management and interaction.

How It Works

The application employs Server-Sent Events (SSE) for real-time, bidirectional communication, enabling instant updates and synchronization with local Claude Code projects. It actively monitors the ~/.claude/projects/ directory for JSONL conversation files, automatically detecting changes and reflecting them in the UI. This approach ensures a live, dynamic experience for task management and conversation tracking.

Quick Start & Requirements

• Primary install/run:
  • Run directly: PORT=3400 npx @kimuson/claude-code-viewer@latest
  • Install globally: npm install -g @kimuson/claude-code-viewer then run claude-code-viewer.
  • Local clone: git clone https://github.com/d-kimuson/claude-code-viewer.git, cd claude-code-viewer, pnpm i, pnpm build, pnpm start.
• Prerequisites: pnpm (v10.8.1) is the specified package manager. Node.js is implicitly required. The application reads data from ~/.claude/projects/.
• Estimated setup: Running via npx is near-instantaneous. Local setup involves cloning and building, which may take a few minutes.
• Links: Contribution guidelines are available at docs/dev.md.

Highlighted Details

• Interactive Claude Code Client: Features include new chat creation, session resumption, real-time task management, and command autocompletion.
• Live Status Indicators: Provides visual feedback for task states (running, paused, completed).
• Real-time Synchronization: Utilizes SSE for live updates, file system monitoring, and an auto-refreshing UI.
• Advanced Conversation Management: Includes a project browser, smart session filtering, a multi-tab interface, and a conversation viewer with syntax highlighting and tool usage display.

Maintenance & Community

No specific contributors, sponsorships, or partnerships are mentioned in the provided README. Contribution guidelines are available in docs/dev.md. Community channels (Discord/Slack) or a roadmap are not detailed.

Licensing & Compatibility

This project is licensed under the MIT License, which generally permits commercial use and integration with closed-source projects without significant restrictions.

Limitations & Caveats

The project is at version 0.1.0, suggesting it may be in an early stage of development. No specific limitations, known bugs, or unsupported platforms are explicitly stated in the README. The application's functionality is tied to the default Claude Code data directory structure (~/.claude/projects/).