tsx

Run a TypeScript file

$ tsx [script.ts]

$ tsx watch [script.ts]

$ tsx

$ node --import tsx [script.ts]

$ tsx [script.ts] --env-file [.env]

$ tsx [script.ts] -- [arg1] [arg2]

tsx [options] [file] [args...]
tsx watch [options] [file]

tsx (TypeScript Execute) is an enhanced Node.js runtime that seamlessly runs TypeScript and ESM files. It uses esbuild for fast transpilation, making it ideal for development and scripting.
The tool requires zero configuration and works without a tsconfig.json file. It supports both CommonJS and ES modules, handles path aliases from tsconfig.json, and includes a watch mode for development.
tsx is a drop-in replacement for node, supporting all Node.js command-line flags. It transpiles TypeScript on-the-fly without writing JavaScript files to disk.
Note that tsx focuses on execution speed and does not perform type checking. Use tsc or your editor for type checking.
Install globally: `npm install -g tsx`

watch

Watch mode: restart on file changes.

Path to tsconfig.json file.

Load environment variables from file.

Disable transform caching.

Display help information.

Display version information.

Does not perform type checking. Adds slight startup overhead for transpilation. For production, pre-compile TypeScript with tsc. Works best with dynamically linked Node.js features.

tsx was created by Hiroki Osame (privatenumber) as a modern alternative to ts-node. It prioritizes speed and simplicity, leveraging esbuild for near-instant transpilation. The project has become popular for running TypeScript during development.

ts-node(1), node(1), tsc(1), esbuild(1)