The TSX with automatic Type-Checking

Run TypeScript files with TSX while providing real-time type checking.

Features

• Real-time type checking alongside tsx execution
• Watch mode with automatic restarts
• Intelligent process management
• Customizable compiler support
• Memory management options
• Config file support (tsx-strict.config.ts / tsxs.config.ts)

Installation

pnpm install -g tsx-strict

Or use with npx:

npx tsxs src/index.ts

Usage

tsxs app.ts

Watch Mode

tsxs --watch app.ts

Skip Type Checking

tsxs --no-type-check app.ts

CLI Options

Option	Description	Default
-w, --watch	Enable watch mode	false
--no-clear	Do not clear screen	false
--compiler	Compiler path	typescript/bin/tsc
--tsc-args <args...>	Additional TypeScript compiler arguments	[]
--tsx-args <args...>	Additional tsx arguments	[]
--silent	Suppress output	false
--no-type-check	Skip type checking (run tsx directly)	false

Config File

Create a tsx-strict.config.ts or tsxs.config.ts at your project root for persistent configuration. CLI args always take precedence over the config file.

import { defineConfig } from "tsx-strict/config";

export default defineConfig({
    watch: true,
    clear: true,
    typeCheck: true,
    compiler: "typescript/bin/tsc",
    tscArgs: ["--strict"],
    tsxArgs: ["--env-file=.env"],
    maxNodeMem: "4096",
});

Watch Options

watch can be true to use defaults, or an object for full control:

import { defineConfig } from "tsx-strict/config";

export default defineConfig({
    watch: {
        include: ["src/**"],
        ignore: ["**/*.test.ts", /generated/, (path) => path.includes("dist")],
        extensions: ["ts", "tsx", "js"],
    },
});

How It Works

Runs tsc --noEmit for type checking and tsx for execution. Restarts tsx only when type checking passes and kills previous instances to prevent conflicts.

Built with ♥️ by Uanela Como