paperclipai/paperclip · error

[paperclip] warning: Node.js ${currentVersion} is unsupporte

Error message

[paperclip] warning: Node.js ${currentVersion} is unsupported. Paperclip requires Node.js ${MINIMUM_NODE_VERSION} or newer.
Upgrade Node.js with your version manager, or follow the recommended downloaded install.sh workflow:
  ${NODE_VERSION_INSTALL_GUIDE_URL}
The piped install.sh form cannot upgrade an unsupported Node.js runtime.
Restart Paperclip after upgrading.

What it means

Error "[paperclip] warning: Node.js ${currentVersion} is unsupported. Paperclip requires Node.js ${MINIMUM_NODE_VERSION} or newer. Upgrade Node.js with your version manager, or follow the recommended downloaded install.sh workflow: ${NODE_VERSION_INSTALL_GUIDE_URL} The piped install.sh form cannot upgrade an unsupported Node.js runtime. Restart Paperclip after upgrading." thrown in paperclipai/paperclip.

Source

Thrown at cli/src/index.ts:277

registerTeamCommands(program);
registerWorktreeCommands(program);
registerEnvLabCommands(program);
registerPluginCommands(program);

const auth = program.command("auth").description("Authentication and bootstrap utilities");

auth
  .command("bootstrap-ceo")
  .description("Create a one-time bootstrap invite URL for first instance admin")
  .option("-c, --config <path>", "Path to config file")
  .option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP)
  .option("--force", "Create new invite even if admin already exists", false)
  .option("--expires-hours <hours>", "Invite expiration window in hours", (value) => Number(value))
  .option("--base-url <url>", "Public base URL used to print invite link")
  .action(bootstrapCeoInvite);

registerClientAuthCommands(auth);

async function main(): Promise<void> {
  warnIfUnsupportedNodeVersion(process.versions.node, (message) => console.warn(message));

  let failed = false;
  try {
    await program.parseAsync();
  } catch (err) {
    failed = true;
    console.error(err instanceof Error ? err.message : String(err));
  } finally {
    await flushTelemetry();
  }

  if (failed) {
    process.exit(1);
  }
}

View on GitHub (pinned to 01ad858492)

Solutions

  1. Upgrade Node.js with your version manager (nvm/fnm/volta)
  2. Use the recommended downloaded install.sh workflow to reinstall a supported runtime
  3. Restart Paperclip after upgrading
  4. Do not rely on the piped install.sh form to upgrade Node
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at cli/src/index.ts:254 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-21). Data as JSON: /api/errors/4476182ec866b3f6. Report an issue: GitHub.