# mourner/flamebearer

A JavaScript CPU trace analysis tool for agents and humans

Repository: https://github.com/mourner/flamebearer
Canonical: https://ross.abutalabs.com/products/flamebearer
Language: JavaScript
License: ISC
License Family: permissive
Topics: performance, profiling, javascript, v8, node, traces
Last push: 2026-06-27T10:04:24+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 89, release rhythm 90, longevity 100
- inputs: {"age_days": 3079, "days_push": 67, "days_rel": 69, "gap_med": 0, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1661, forks 29 (observed 2026-08-28T04:05:18.551710+00:00)

## What it is
A command-line tool that analyzes JavaScript CPU profiles from Chrome DevTools Performance recordings and Node .cpuprofile files, printing compact text summaries of top CPU offenders, hot source lines, and long tasks. It is designed for performance optimization loops and works for both humans and AI agents, with no GUI required.

## Use cases
- summarize a node --cpu-prof cpuprofile from the terminal
- analyze a Chrome DevTools Performance trace as text
- find the hottest functions and source lines in a JS CPU profile
- profile a Node script and see top CPU offenders
- drill into a specific function's stacks in a CPU trace
- feed CPU profile analysis to an AI agent for optimization
- identify long tasks in a performance recording

## When to choose
- you want fast, text-based CPU profile analysis without a GUI
- you are optimizing Node.js or browser JavaScript performance in a terminal or automated loop
- you need machine-readable-ish summaries of .cpuprofile or DevTools traces for agents

## When to avoid
- you want visual flame graph exploration in a browser — use Speedscope or Chrome DevTools instead
- you need to profile languages other than JavaScript/V8
- you need heap/memory profiling rather than CPU analysis

## Facets
- artifact type: cli-tool
- maturity: active
- function: benchmarking, developer-tools, cli, monitoring
- domain: developer-tools, performance
- platform: cli, cross-platform
- tags: cpu-profiling, flame-graphs, v8, chrome-devtools, cpuprofile, performance-analysis, terminal, command-line, javascript, nodejs

## Member repositories
- mourner/flamebearer (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.551710+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:44:38.355180+00:00, confidence not recorded.
  - readme: https://github.com/mourner/flamebearer (fetched 2026-08-28T04:05:18.551710+00:00, sha c214a4746b31)
- Data as of 2026-08-30T08:39:29.467469+00:00.