v8-utils

CLI and MCP tools for V8 JavaScript engine developers.

Requirements

• Python 3.12+
• uv
• luci-auth on $PATH (for Pinpoint job creation)
• gcloud auth application-default login (optional, for CAS data access)

Installation

# Full developer install (all CLIs and MCP tool groups):
uv tool install "v8-utils[all] @ git+https://github.com/schuay/v8-utils.git"
# Upgrade:
uv tool upgrade v8-utils

The base install (no extras) is intentionally light -- only the MCP server core and the tool groups that shell out to git (repo_git_*), manage worktrees, and talk to Gerrit. The heavy scientific/cloud stack lives in optional extras that the MCP server loads lazily; groups whose extra is missing are skipped at startup with a warning naming the extra to install:

Extra	Enables
analysis	the pd MCP group and the pd / jsb CLIs (numpy/pandas/scipy/ruptures)
pinpoint	the pinpoint MCP group and the pp CLI
gchat	the Google Chat frontend (pp daemon)
spanner	the Spanner-backed perf timeseries adaptor
all	everything above -- the full developer surface

A minimal MCP-only deployment that just needs the git-backed repo tools can install the base package (uv tool install git+...); everyone else wants [all].

Configuration

Create ~/.config/v8-utils/config.toml:

user = "you@chromium.org"

Run pp config to see all available options.

CLI tools

• pp — Pinpoint job management: create, list, inspect, compare results, watch with notifications. Run pp --help for usage.
• jsb — JetStream/Speedometer benchmark runner and result comparison.
• pd — Performance data analysis: change-point detection and AB comparison.

MCP server

v8-mcp exposes tools for use with AI assistants (Claude, Gemini, etc.):

• Pinpoint — create/list/inspect jobs, compare results
• Perf — hotspot analysis, flamegraphs, annotation, TMA, stat, diff
• Repository — git grep/find/log/show across configured repos
• Gerrit — fetch CLs and comments
• Godbolt — compile C/C++ snippets and inspect assembly, with llvm-mca and optimization remarks
• d8 — run scripts, trace index for navigating verbose V8 trace output

Add to your MCP client config (e.g. ~/.gemini/settings.json):

{
  "mcpServers": {
    "v8-utils": {
      "command": "v8-mcp"
    }
  }
}