run

js/cli/run.md

fino run is the normal way to start an application, script, worker entry point, or one-off maintenance module with the Fino runtime. Use it when you want the runtime loader, built-in modules, OpenTelemetry bootstrap, and watch mode around a single entry module. The root shortcut fino <script> uses the same command path, so these forms are equivalent:

fino run app.ts
fino app.ts

The command accepts one entry module. Relative and bare path-like inputs are resolved from the current working directory and imported through the runtime loader. Directories and glob patterns are not expanded because run starts one program, not a collection of files.

Command Reference

Arguments after the script name belong to the script. A -- separator is not required:

fino run app.ts --config ./config.toml

Use -- only when you need to stop Fino option parsing before the entrypoint. For example, fino run -- --flag-shaped-file.ts treats --flag-shaped-file.ts as the script path instead of a Fino option.

The script can read the runtime argv through fino:process.

Use --watch for local server or worker development. Watch mode runs the entry module in a watched child realm, tracks imported modules, and restarts the child when those modules change:

fino run --watch server.ts --port 3000

--otlp-endpoint wins over OTEL_EXPORTER_OTLP_ENDPOINT. Set OTEL_SDK_DISABLED=true to disable CLI OpenTelemetry bootstrap entirely. Realms constructed by the script inherit the CLI endpoint by default. Pass otlpEndpoint to new Realm(...) to override the collector for a child realm, or pass false to disable CLI OpenTelemetry bootstrap for that child.