🚀 Developer productivity visibility. Track and analyze build, test, and other process times to gain insights, spot trends, and iterate faster. Local-first — no data leaves your machine unless you opt in.
⚠️ Beta Release Notice
ProcessLens is currently in beta. While core features are stable, you may encounter bugs or rough edges.🙏 We need your feedback! Please report issues, suggestions, or feature requests:
Your input helps make ProcessLens better for everyone! 🚀
Every developer waits for builds and tests. Even a few seconds repeated hundreds of times a day adds up. Without measurement, teams only feel slowdowns — ProcessLens makes them visible.
Why it matters:
- ⏱ Seconds add up into hours
- 📊 Evidence, not guesses — real data on your flow
- 📈 Trends over time — catch creeping slowdowns
- 👥 Team value — justify infra improvements with data
- 🔍 Personal utility — OSS maintainers & indie devs spot regressions
What makes it different:
- 🌍 General-purpose: measure any process, not just JS builds
- 📉 Trend-focused: not just “this run took 9s” but “build times doubled this quarter”
- 💻 Developer-first: lives in VS Code, zero-config, instant insight
Think of it as time tracking for machines, not humans. Humans log hours worked. ProcessLens logs seconds wasted waiting on computers.
- Global stats: total runs, commands tracked, success rate, active projects
- Recent durations chart with interactive hover details
- Command summary table with customizable columns
- Recent runs list with trend indicators
- Average, Median, P95, Min/Max execution times
- 7-day trend analysis (↘ faster, ↗ slower, → stable)
- Success rate monitoring
- Hardware change detection
Identify your biggest time sinks with smart calculations:
- Total Time — cumulative consumption (duration × frequency)
- Impact Score — relative impact (0–100) compared to top offender
- Time/Day — average daily time wasted
- Optimization Priority — focus on high-impact commands first
- Beautiful visualizations — color-coded bars (green → red)
Example: A command that runs 50× at 2s each (100s total) has higher impact than a command that runs 2× at 30s (60s total).
Estimate potential savings from command optimizations:
- Projected Savings — time saved if optimized
- Optimization Priority — HIGH/MEDIUM/LOW based on multiple factors
- ROI Analysis — prioritize where effort yields most benefit
- Trend Velocity — track if commands are improving or degrading
Smart scoring factors:
- Impact score
- Performance trends
- Variability (consistency)
- Frequency
Conservative estimates:
- HIGH: 30% potential savings
- MEDIUM: 15%
- LOW: 5%
Example: A HIGH priority command running 100× at 10s average could save ~5 minutes total if improved by 30%.
- Customizable columns
- Trend sparklines (mini charts)
- Clickable stats to filter recent runs
- One-click re-run (▶)
- Smart filtering by project, command, time, status, device
- Shell history integration (bash/zsh/fish)
- Auto-discovery of
package.jsonscripts (npm/yarn) - Run any shell command with timing + status
- Multi-project support
VS Code / Cursor / Windsurf:
- Install ProcessLens from the VS Code Marketplace
- Open any workspace/project
- Press
Ctrl+Shift+P(orCmd+Shift+Pon Mac) - Run "ProcessLens: Run Command"
VSCodium / Gitpod / Eclipse Theia:
- Install from Open VSX Registry
- Or search "ProcessLens" in your editor's extension marketplace
- Follow steps 2-4 above
ProcessLens works with any VS Code-compatible editor:
| Editor | Marketplace | Status |
|---|---|---|
| VS Code | VS Code Marketplace | ✅ Full support |
| Cursor | VS Code Marketplace | ✅ Full support |
| Windsurf | VS Code Marketplace | ✅ Full support |
| VSCodium | Open VSX Registry | ✅ Full support |
| Gitpod | Open VSX Registry | ✅ Full support |
| Eclipse Theia | Open VSX Registry | ✅ Full support |
For best visuals with OS icons, install a Nerd Font (MesloLGS NF, FiraCode NF, Hack NF, JetBrains Mono NF).
- macOS
brew tap homebrew/cask-fonts
brew install font-meslo-lg-nerd-font- Linux (Ubuntu/Debian)
mkdir -p ~/.local/share/fonts
curl -fLo "MesloLGS NF Regular.ttf" https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/Meslo/S/Regular/MesloLGSNerdFont-Regular.ttf
curl -fLo "MesloLGS NF Bold.ttf" https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/Meslo/S/Bold/MesloLGSNerdFont-Bold.ttf
mv *.ttf ~/.local/share/fonts/
fc-cache -fv- Windows Download from Nerd Fonts, extract, right-click → Install.
(Note: Works fine without Nerd Fonts — falls back to emoji icons 🍎 🐧 💻)
- ProcessLens: Run Command — Execute & time any command
- ProcessLens: Open Dashboard — View analytics dashboard
- 📜 Browse Shell History via command picker
- 📦 package.json Scripts auto-discovered
- ⋯ Column Customization in Command Summary
- 📈 Trend Analysis column shows 7-day performance
- 🖥 Hardware Tracking auto-annotates changes
Global Stats (Top Bar)
- Total Runs | Commands Tracked | Success Rate | Active Projects
Chart
- Color-coded dots: 🟢 success, 🔴 fail, 🟡 unknown
- Hardware annotations (vertical lines)
- Hover tooltips for command details
Command Summary Table
- Default: Command | Runs | Average | Success Rate
- Optional: Median | P95 | Min | Max | Trend | Sparkline
- Sortable + clickable
- Play ▶ buttons for quick re-run
Statistical Columns Explained
- Average — mean execution time
- Median — middle value, less skewed by outliers
- P95 — 95th percentile (worst-case)
- Min/Max — fastest/slowest times
- Trend — 7-day comparison (↗ slower, ↘ faster, → stable)
- Sparkline — mini chart of recent times
processlens.captureDeviceInfo(default: true)processlens.statusBar.enabled(default: true)processlens.statusBar.priority(default: -10)processlens.storage.backend—"jsonl"(default),"sqlite"planned
ProcessLens is 100% local-first.
- Stores timing data locally in VS Code global storage.
- Data collected: command execution times, exit codes, project info (hashed), device info, timestamps.
- No external servers.
- Cloud sync will always be opt-in.
- ⏱ Watch-mode rebuild timings (Vite, Webpack, Jest)
- 🗄 SQLite backend for faster querying
- ☁️ Cloud sync (opt-in) → team dashboards & history
- 📊 Advanced analytics: regressions, p50/p95 trends, team comparisons
- 🔔 Alerts & recommendations
npm i
npm run compile
# Press F5 in VS Code to launch Extension Development Hostnpx vsce packageFound a bug or have a feature request? Please open an issue or submit a pull request.
MIT License - see LICENSE file for details.