Serve

Synopsis

tman serve [options]

There are no positional arguments.

Options

Flag	Behavior
-p, --port <port>	Optional local server port. Defaults to 3847.
--open	Ask the operating system to open the web interface after startup.

Behavior

serve starts the local web server and exposes the UI plus its API routes. The command delegates startup and an optional browser opener to the web server implementation. It does not establish authentication, and this documentation makes no bind-host guarantee beyond the server’s source-defined startup behavior.

POST /api/preview validates input and generates a scheme response without writing files. Web actions can still mutate state: favorite endpoints update configuration, and POST /api/generate validates input before invoking the write-generating pipeline. API validation and handler failures return route errors rather than silently accepting invalid data.

Examples

tman serve
tman serve --port 8080
tman serve --open

An unavailable/invalid port or startup failure is reported as a command error and exits nonzero. Successful startup keeps the process running until it is stopped.