CLI · Nylorun Docs

@nylorun/cli · beta

nylorun <runtime|up|down|logs|dev|serve|configure|studio|doctor>

  runtime start [--foreground] [--restart] [--port <n>] [--db <path>] [--global]
  runtime stop [--global] [--timeout <seconds>]
  runtime status [--output json] [--global]
  runtime logs [-f] [-n <lines>] [--global]
  up                       alias for "runtime start"
  down                     alias for "runtime stop"
  logs                     alias for "runtime logs"

  dev [--no-studio] [--no-open] [--no-autostart] [--port <n>]
  serve [entry] [--no-autostart] [--port <n>]
  configure [--global]
  studio [--runtime-url <http(s)-url>] [--port <n>] [--no-open]
  doctor sandbox [--json]  show which sandbox backend this machine offers

The nylorun binary is @nylorun/cli. Requires Node 24+. Generated applications install CLI as a production dependency because serve uses it. nylorun start is removed; use nylorun serve.

Command	Description
`nylorun up` / `runtime start`	Start the persistent Runtime.
`nylorun down` / `runtime stop`	Stop Runtime; keep `.nylorun/`.
`nylorun runtime status`	Scope, URL, PID, versions, paths. Exit `3` stopped, `4` port-conflict.
`nylorun logs`	Tail `runtime.log` (`-n` default 200).
`nylorun dev`	Watch `agents/index.ts`, ensure Runtime, connect the executor, optionally open Studio.
`nylorun serve [entry]`	Load `dist/agents/index.js` by default without Studio or watching.
`nylorun configure`	Write the host model credential to the vault. Requires a running Runtime (exit `6` otherwise).
`nylorun studio`	Attach Studio through the trusted proxy. `--runtime-url` is an optional override. Implemented Studio port flag: `--studio-port`.
`nylorun doctor sandbox`	Probe the sandbox backend.

--no-autostart on dev / serve fails if no Runtime is listening instead of spawning one.

Creator (npm create @nylorun/agent) is @nylorun/create-agent, not this binary. Its flags are --no-studio, --no-open, and --yes.

Guide: Run.