setup-node

Setup Node Project

Resolve target

If $ARGUMENTS blank: work in current dir, use its name as project name. If $ARGUMENTS given: create and enter ./$ARGUMENTS.

Prerequisites

Verify node and corepack are available. Stop if missing. Enable pnpm via corepack: corepack enable pnpm.

Initialize

If no package.json: scaffold with pnpm create vitest@latest — do NOT use pnpm init or tsc --init. Choose TypeScript + Node environment when prompted.

Install missing tooling with pnpm add -D: tsx, @types/node, eslint, eslint-config-agent, prettier — skip any already in devDependencies.

Configure

For each file: create if missing, update if present but incomplete — never overwrite user customizations.

• tsconfig.json — strict TypeScript, NodeNext module resolution, ES2022 target, src → dist
• eslint.config.js — extend eslint-config-agent only, no custom rules
• .prettierrc — sensible defaults (100 width, trailing commas, double quotes)
• .gitignore — append node_modules/, dist/, .env* if not already excluded
• .env.example — add NODE_ENV=development if missing
• .node-version — write current node major only if missing

Starter files

Create src/index.ts and src/index.test.ts only if they don't exist.

Git hooks

Set up git hooks for pre-commit and pre-push quality checks. Skip if hooks already configured.

Verify

Run pnpm typecheck. Report errors but do not fail.

Done

Output project name, dir, and key commands: pnpm dev, pnpm test, pnpm typecheck.