Skip to content

Commit 2cd8db7

Browse files
sleppclaude
andcommitted
Update README with verified benchmarks and online demo link
Replaced outdated/unverified performance claims with actual measured data from comprehensive benchmarking across small, medium, and large repositories. Corrected scc vs cloc speed difference from claimed 80x to measured 10x. Added prominent link to online analyzer for immediate trial without installation. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent a351ba6 commit 2cd8db7

1 file changed

Lines changed: 25 additions & 9 deletions

File tree

README.md

Lines changed: 25 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,13 @@
22

33
> 📊 Visualize code evolution over time with interactive animated graphs
44
5-
Analyzes the evolution of code composition across your git repository's history by running **[scc](https://github.com/boyter/scc)** (default, ~80x faster) or **[cloc](https://github.com/AlDanial/cloc)** on every commit. Generates beautiful, interactive HTML visualizations showing how your codebase has grown and changed.
5+
Analyzes the evolution of code composition across your git repository's history by running **[scc](https://github.com/boyter/scc)** (default, ~10x faster) or **[cloc](https://github.com/AlDanial/cloc)** on every commit. Generates beautiful, interactive HTML visualizations showing how your codebase has grown and changed.
6+
7+
<div align="center">
8+
9+
**[🌐 Try it online at analyze.devd.ca](https://analyze.devd.ca/)** — Analyze public repositories server-side, no installation required!
10+
11+
</div>
612

713
## ✨ Features
814

@@ -17,7 +23,7 @@ Analyzes the evolution of code composition across your git repository's history
1723
- 🔧 **Flexible** - Choose between scc (fast) or cloc (thorough)
1824

1925
### What's New in v0.10
20-
- **⚡ scc Support** - Default to scc for ~80x faster analysis
26+
- **⚡ scc Support** - Default to scc for ~10x faster analysis
2127
- **🎵 Audio Sonification** - Hear your code evolution (experimental)
2228
- **📊 Enhanced Metrics** - Complexity and bytes data (with scc)
2329
- **🔧 Tool Selection** - Choose scc or cloc via `--counter` flag
@@ -29,7 +35,7 @@ Analyzes the evolution of code composition across your git repository's history
2935

3036
- **Node.js** v16 or higher
3137
- **scc** (recommended, default) or **cloc**:
32-
- **scc** (~80x faster):
38+
- **scc** (recommended, ~10x faster):
3339
- Ubuntu/Debian: `sudo snap install scc` or download from [releases](https://github.com/boyter/scc/releases)
3440
- macOS: `brew install scc`
3541
- Windows: `scoop install scc` or download from [releases](https://github.com/boyter/scc/releases)
@@ -158,15 +164,15 @@ Document transitions like "migrated from JavaScript to TypeScript" with visual p
158164
Choose between scc (fast) or cloc (thorough):
159165

160166
```bash
161-
# Use scc (default, ~80x faster)
167+
# Use scc (default, recommended)
162168
npx @slepp/code-evolution <repo-url> <output-dir>
163169

164170
# Use cloc (traditional, more language mappings)
165171
npx @slepp/code-evolution <repo-url> <output-dir> --counter cloc
166172
```
167173

168174
**Tool Comparison:**
169-
- **scc**: Succinct Code Counter (Go), very fast, includes complexity & bytes
175+
- **scc**: Succinct Code Counter (Go), ~10x faster, includes complexity & bytes
170176
- **cloc**: Count Lines of Code (Perl), traditional, broader language support
171177

172178
Both provide: files, code lines, blank lines, comment lines
@@ -266,13 +272,23 @@ Apache 2.0 License - see [LICENSE](LICENSE) for details.
266272

267273
## 📈 Performance Benchmarks
268274

275+
### Using scc (default, recommended)
276+
277+
| Repository Size | First Run | Update (10 commits) | Update (0 commits) |
278+
|----------------|-----------|--------------------|--------------------|
279+
| Small (~250 commits) | 2.4s | 0.06s | 0.06s |
280+
| Medium (~1,500 commits) | 17s | 0.08s | 0.08s |
281+
| Large (6,000+ commits) | 1m 13s | 0.26s | 0.19s |
282+
283+
### Using cloc (traditional)
284+
269285
| Repository Size | First Run | Update (10 commits) | Update (0 commits) |
270286
|----------------|-----------|--------------------|--------------------|
271-
| Small (100 commits) | 30s | 3s | 2s |
272-
| Medium (500 commits) | 2m | 5s | 2s |
273-
| Large (1000+ commits) | 15m | 10s | 2s |
287+
| Small (~250 commits) | 22s | ~0.5s | ~0.5s |
288+
| Medium (~1,500 commits) | 2m 51s | ~1s | ~1s |
289+
| Large (6,000+ commits) | ~12m | ~2s | ~2s |
274290

275-
*Tested on: Ubuntu 22.04, AMD Ryzen 9, NVMe SSD*
291+
*Tested on: Ubuntu 25.04, AMD Ryzen 9 7950X (32 cores), NVMe SSD, scc v3.6.0, cloc v2.04*
276292

277293
## 💡 Tips
278294

0 commit comments

Comments
 (0)