rundir

rundir is a small CLI that tries to run a directory as a Node.js, Python, or .NET app.

It checks in this order:

1. Node.js project
2. Python project
3. .NET project

If none match, it exits with an error.

Install

Global

pnpm add -g rundir

One-off with pnpm dlx

pnpm dlx rundir

Usage

Run current directory:

rundir

Run a specific directory:

rundir ./path/to/project

Detection rules

Node.js

• If package.json has a start script, runs that script.
  • Uses pnpm start if pnpm-lock.yaml exists
  • Uses yarn start if yarn.lock exists
  • Uses bun start if bun.lock or bun.lockb exists
  • Otherwise uses npm run start
• Else if package.json.main points to an existing file, runs node <main>.
• Else if index.js exists, runs node index.js.

Python

• Runs the first matching file with python:
  • main.py
  • app.py
  • run.py
  • server.py
  • __main__.py

.NET

• If one or more .csproj files exist, runs:
  • dotnet run --project <project-file>
  • Prefers <directory-name>.csproj when present
• Else if a .sln file exists, runs dotnet run.

Development

Install dependencies:

pnpm install

Build:

pnpm run build

Type-check:

pnpm run typecheck

Run locally in dev mode:

pnpm run dev -- [directory]

Run built CLI directly:

node dist/index.js [directory]

Publish to npm

1. Update version in package.json
2. Login to npm:

   pnpm login

3. Publish:

   pnpm publish

prepack runs automatically before publish and creates a fresh build.