TypeScript

tsx Commands

Use tsx for blazing-fast TypeScript execution powered by esbuild. Run TypeScript files, watch for changes, and execute scripts without configuration.

7 commands

Pro Tips

Run any TypeScript file: 'npx tsx script.ts' — works with ESM, CommonJS, and mixed projects.

Use 'tsx watch app.ts' for development with automatic restarts on file changes.

tsx supports path aliases from tsconfig.json out of the box — no additional configuration needed.

Common Mistakes

tsx (via esbuild) strips types but doesn't check them. Still run 'tsc --noEmit' separately for type safety.

Some TypeScript features like const enums and namespace merging aren't supported by esbuild.

Commands

Run with tsx

$ tsx src/index.ts

Execute TypeScript with near-instant compilation (~20ms).

tsx watch mode

$ tsx watch src/index.ts

Auto-restart on file changes (built-in hot reload).

tsx with ignore paths

$ tsx watch --ignore ./logs --ignore ./temp src/index.ts

Watch mode excluding specific directories.

tsx REPL

$ tsx

Start fast interactive TypeScript REPL.

tsx with Node flags

$ tsx --inspect src/index.ts

Pass Node.js flags through (debugging, env, etc.).

tsx with env file

$ tsx --env-file=.env src/index.ts

Load environment variables from file.

Development workflow

$ tsc --noEmit --watch & tsx watch src/index.ts

Parallel type checking and execution (recommended).