What is upgrade-nodejs?

A maintenance guide for changing the Node.js version Bun reports for compatibility. Node.js is a JavaScript runtime, and native addons are compiled extensions that depend on its interfaces and binary compatibility.

Use it when upgrading Bun's reported Node.js version and checking related bootstrap scripts, build settings, version strings, and N-API definitions.

It shows which version, ABI, API, and compatibility values must stay aligned, reducing failures in Node.js packages and native addons after a version change.

upgrade-nodejs — Command for Claude Code by twaldin

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo

git clone --depth 1 https://github.com/twaldin/hone

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/commands/twaldin/hone/upgrade-nodejs/github.svg)](https://agentmods.dev/commands/twaldin/hone/upgrade-nodejs)

Your own site

<a href="https://agentmods.dev/commands/twaldin/hone/upgrade-nodejs"><img src="https://agentmods.dev/badge/commands/twaldin/hone/upgrade-nodejs/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/commands/twaldin/hone/upgrade-nodejs"><img src="https://agentmods.dev/badge/commands/twaldin/hone/upgrade-nodejs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 876 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00000	$0.00876
Opus 5	$0.00000	$0.00438
Sonnet 5	$0.00000	$0.00175
Haiku 4.5	$0.00000	$0.00088

Measured yesterday against content hash 1c41b09fcb3d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

upgrade-nodejs scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s https://nodejs.org/dist/index.json | jq '.[0]'

capsules/bun-module-loader/.candidate-5187e276/.claude/commands/upgrade-nodejs.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Upgrading Bun's Self-Reported Node.js Version

This guide explains how to upgrade the Node.js version that Bun reports for compatibility with Node.js packages and native addons.

Overview

Bun reports a Node.js version for compatibility with the Node.js ecosystem. This affects:

process.version output
Node-API (N-API) compatibility
Native addon ABI compatibility
V8 API compatibility for addons using V8 directly

Files That Always Need Updates

1. Bootstrap Scripts

scripts/bootstrap.sh - Update NODEJS_VERSION=
scripts/bootstrap.ps1 - Update $NODEJS_VERSION =

2. CMake Configuration

cmake/Options.cmake
- NODEJS_VERSION - The Node.js version string (e.g., "24.3.0")
- NODEJS_ABI_VERSION - The ABI version number (find using command below)

3. Version Strings

src/jsc/bindings/BunProcess.cpp
- Update Bun__versions_node with the Node.js version
- Update Bun__versions_v8 with the V8 version (find using command below)

4. N-API Version

src/napi/js_native_api.h
- Update NAPI_VERSION define (check Node.js release notes)

Files That May Need Updates

Only check these if the build fails or tests crash after updating version numbers:

V8 compatibility files in src/jsc/bindings/v8/ (if V8 API changed)
Test files (if Node.js requires newer C++ standard)

Quick Commands to Find Version Info

# Get latest Node.js version info
curl -s https://nodejs.org/dist/index.json | jq '.[0]'

# Get V8 version for a specific Node.js version (replace v24.3.0)
curl -s https://nodejs.org/dist/v24.3.0/node-v24.3.0-headers.tar.gz | tar -xzO node-v24.3.0/include/node/node_version.h | grep V8_VERSION

# Get ABI version for a specific Node.js version
curl -s https://nodejs.org/dist/v24.3.0/node-v24.3.0-headers.tar.gz | tar -xzO node-v24.3.0/include/node/node_version.h | grep NODE_MODULE_VERSION

# Or use the ABI registry
curl -s https://raw.githubusercontent.com/nodejs/node/main/doc/abi_version_registry.json | jq '.NODE_MODULE_VERSION."<version>"'

Read the full file on GitHub · 92 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

yesterday First seen · 92 lines · 0 tokens per session scan A 1c41b09fcb3d

Subscribe to this mod's changes

upgrade-nodejs is a command published in the GitHub repository twaldin/hone (47 stars, last pushed yesterday), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 876 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-07.

C and C++Languages anthropic chatgpt claude cli coding-agent gepa

cpp-test

Enforce TDD workflow for C++. Write GoogleTest tests first, then implement. Verify coverage with gcov/lcov.

affaan-m/ECC · 25 tokens

cpp-build

Fix C++ build errors, CMake issues, and linker problems incrementally. Invokes the cpp-build-resolver agent for minimal, surgical fixes.

affaan-m/ECC · 30 tokens

cpp-review

Comprehensive C++ code review for memory safety, modern C++ idioms, concurrency, and security. Invokes the cpp-reviewer agent.

affaan-m/ECC · 29 tokens

atomic-plan

Write a design doc (concepts, business rules, approaches) and a checkpoint-table spec (contract) for non-trivial work; inline spec only for trivial. Gauges triviality; loops spec authoring with subagents. Human-facing artifact, Mermaid diagrams allowed.

damusix/atomic-claude · 54 tokens

setup

Set up Duel Agents routing with your Duel API key.

2aronS/Duel-Agents · 10 tokens

cwb-relax

A command that searches for relaxing music in three styles: downtempo, acoustic folk, and nature ambience.

jaychempan/coding-with-beat · 37 tokens

upgrade-nodejs