godseye-test-heap-leaks

Compare V8 heap snapshots to quantify memory growth in test suites.

4|2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/bitan-del/gods-eye --skill godseye-test-heap-leaks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godseye-test-heap-leaks
Source: https://github.com/bitan-del/gods-eye/tree/main/.agents/skills/godseye-test-heap-leaks
Command: npx skills add https://github.com/bitan-del/gods-eye --skill godseye-test-heap-leaks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps identify and diagnose memory growth and potential leaks in test environments by collecting and comparing heap snapshots across workers and lanes.

Core Features & Use Cases

  • Heap snapshot collection during test runs to capture memory footprints.
  • Delta analysis to compare before/after snapshots and surface large growth in specific object kinds.
  • Lane-based grouping to identify leaks across parallel workers and CI shards.
  • Guidance on classifying growth as retained module growth vs runtime object leaks, enabling targeted fixes.

Quick Start

Run the test suite with memory tracing enabled and compare two heap snapshots using scripts/heapsnapshot-delta.mjs.

Frequently Asked Questions about godseye-test-heap-leaks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose test memory leaks using heap snapshots in Node?

Diagnose test memory leaks by collecting V8 heap snapshots during test runs and comparing before/after deltas to surface large growth in specific object kinds. This Node-based CLI consumes snapshots to quantify memory growth across workers.

Can I analyze heap snapshot deltas across parallel CI workers and lanes?

Yes, you can analyze heap snapshot deltas across parallel CI workers by applying lane-based grouping. This identifies memory leaks across multiple workers or CI shards in Linux environments, producing actionable deltas with optional PID filtering.

What is the best way to identify retained module growth versus runtime object leaks?

Identify retained module growth versus runtime object leaks by comparing heap snapshot deltas and classifying the surfaced growth. This guidance enables targeted fixes by distinguishing retained module growth from actual runtime object leaks.

How do I compare two heap snapshots to quantify memory growth?

Compare two heap snapshots to quantify memory growth by running the test suite with memory tracing enabled and using the heapsnapshot-delta.mjs script. This produces actionable deltas that surface large growth in specific object kinds.

Does this heap snapshot delta analysis tool work in local Linux CI environments?

Yes, this heap snapshot delta analysis applies in Linux CI environments and local runs. It consumes V8 heap snapshots across multiple workers or lanes to produce actionable memory growth deltas.

Why does my Node test suite memory keep growing across multiple runs?

Your Node test suite memory grows due to potential leaks identified by comparing V8 heap snapshots. Collecting before/after snapshots and analyzing lane-based deltas surfaces large growth in specific object kinds causing the memory increase.