flamebearer Files

This project used to be about generating an HTML flamegraph for Node traces, but then lay dormant since 2018. In 2026, as of v2.0.0, it is revived with a new purpose: to be a useful CLI tool in the age of AI.

Flamebearer is now a CLI that summarizes CPU traces for AI agents and humans, designed for JavaScript performance optimization loops. Reads Chrome DevTools Performance recordings (.json / .json.gz) and Node .cpuprofile files, and prints a compact, structured text summary — top CPU offenders, hot source lines, long tasks, with a way to drill down further.

:::bash
npm install -g flamebearer

# Profile a Node script (wraps `node --cpu-prof`)
flamebearer-node bench.js

# Summarize a Chrome DevTools or node --cpu-prof trace
flamebearer profile.json.gz
flamebearer CPU.*.cpuprofile