komrad

komrad serve

Run the komrad server in the foreground

komrad

komrad serve [flags]

It opens the database, mounts the Connect handlers and the MCP endpoint on one address, runs the loops that read each pane's state and sync transcripts, and fires schedules. The panel and the rest of these commands are clients of it, so nothing works without it.

While connection.database_url names the embedded Postgres, it starts the embedded Postgres first and starts it again whenever it exits.

It writes its log to komrad.log in the cache directory, starting a new file once log.max_size_mb is reached. komrad start spawns this detached, which is how it usually runs. Run it here to watch the log on the terminal as well. It stops on an interrupt, or when komrad stop asks it to.

Flags#

FlagTypeDescription
--addrstring

listen address, defaulting to KOMRAD_ADDR

Inherited flags#

FlagTypeDescription
--configstringArray

path to a config TOML, repeatable, later files win over earlier ones

--enginestring

engine to reach: local for this machine, or a file in the config's engines directory, layered over the config