Skip to content

command over server #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
abhinavm24 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

command over server #3

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,11 @@ Thumbs.db
*.swp
*.swo

# Build / dist
dist/
build/
*.egg-info/

# Env
.env
.env.*
25 changes: 19 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,20 +24,33 @@ https://github.com/user-attachments/assets/4f194751-f81f-473f-aa35-3203a7c414d6

## Quick Start

### Option A: pip install (recommended)

```bash
pip install claude-code-visualizer
claude-viz --open
```

This generates a single self-contained HTML file (`claude-code-viz.html`) that works offline — no server needed. Just open it in your browser.

```bash
# Options
claude-viz -o my-report.html # Custom output path
claude-viz --claude-dir ~/path # Custom .claude directory
claude-viz --open # Auto-open in browser
```

### Option B: Clone and run

```bash
# 1. Clone
git clone git@github.com:aybidi/claude-code-visualizer.git
cd claude-code-visualizer

# 2. Generate your data (reads from ~/.claude/)
python3 process_data.py

# 3. Serve locally and open
python3 -m http.server 8765
# Visit http://localhost:8765
Comment on lines +43 to 50
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quick Start "Option B" still instructs generating data.json via process_data.py and serving with http.server, which conflicts with the new "self-contained HTML" workflow (and the PR's stated goal of no server). Update Option B to use the new CLI/module entry point (e.g., editable install + claude-viz / python -m claude_code_visualizer) and remove the server step, or clearly label Option B as the legacy workflow.

Copilot uses AI. Check for mistakes.
```

That's it. No dependencies, no `npm install`, no build step.
No dependencies, no `npm install`, no build step.

## Requirements

Expand Down
Loading
Loading