tama serve

Runs the loopback HTTP/JSON backend used by Tama Desktop.

#Invocation

tama serve [--port N] [--root <release-path>]

--port accepts an unsigned 16-bit port and defaults to 0 for an OS-assigned port. --root selects the sealed hook release used by backend operations.

#Output and state

The server binds only 127.0.0.1, writes exactly one ready line {"ready":true,"port":N}, then serves /v1/health, coverage, install plan, MCP config, violation scan, and cleanup endpoints. Scan and cleanup jobs stream NDJSON and cleanup may modify the requested repository.

#Refusals and failures

• Missing values: missing value for --port or missing value for --root, exit 2.
• Invalid port: invalid --port: <value>, exit 2.
• Any other argument: unknown serve option: <argument>, exit 2.
• Bind failure: the operating-system error is written to stderr and the command exits 1.

Return to the complete CLI command tree.