TSX(1)

📦 version 4.22.4, in ubuntu stonking

💅 tsx — bestie edition 💅

okay so this is TSX(1), part of User Commands, and it's genuinely one of my favorite little tools ever. sit down, grab a strawberry 🍓, and let me put you on.

✨ NAME ✨

tsx — a Node.js runtime that's been enhanced with esbuild, so it can load your TypeScript & ESM files like it's literally nothing. no cap.

🦋 SYNOPSIS 🦋

tsx [flags...] [script path]
tsx command

🌸 DESCRIPTION 🌸

so here's the tea, bestie: tsx is a Node.js runtime enhanced with esbuild, and what that means for you is that it enables direct execution of TypeScript and ESM (ECMAScript Module) files — and it does it without a separate compilation step. no build watcher, no tsc in another tab, no "wait did I rebuild?" panic. it just runs. it's giving main character energy honestly. 😭💖

👑 COMMANDS 👑

  • watch — runs the script and watches for changes. the second your script or any of its dependencies get modified, it automatically restarts the process. yes fr fr, it's obsessed with keeping you up to date. 🔥

💅 FLAGS 💅

  • -h, --help — shows the help information and then exits. your little "what do I do now" bestie. 🫶
  • --no-cache — disables caching of compiled files. turn it off, live your truth. ✨
  • --tsconfig string — lets you specify a custom tsconfig.json path to use instead of the default one. your config, your rules. 💜
  • -v, --version — shows the current version and exits. quick lil vibe check. 🌈

🎀 EXAMPLES 🎀

run a TypeScript file, easy peasy:

tsx script.ts

run a file and watch for changes (my personal fave, so cozy):

tsx watch script.ts

run with a custom tsconfig, because sometimes you have options:

tsx --tsconfig ./tsconfig.prod.json script.ts

🌟 SEE ALSO 🌟

node(1), ts-node(1) — go say hi to the cousins, they're sweet I promise. 🧚

and that's the whole page, gorgeous. this was tsx, dated 2026-05-05, from the TSX(1) era of the manual. slay, periodt, go run something. 💖🔥👑

📦 where this page comes from