Skip to content
Cockpit0.29.0
A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live

majordomus serve

Serve the same capabilities over HTTP on the loopback interface, with the home page, /openapi.json, /swagger and the documentation under /docs/

What it is

read only

Serve the same capabilities over HTTP on the loopback interface, with the home page, /openapi.json, /swagger and the documentation under /docs/

Identity
executable.serve
Program
executable
Runs
long running
Requires
repositorylayer
No machine surface carries this command: serves until it is stopped; a request/response surface cannot carry it

Where it appears

Command line
majordomus serve
Workflow
just serve
MCP tool
—
HTTP
—
Declared in
apps/majordomus-cli/src/cli.rs
Capability
—

Arguments

argumentvalues fromrequiredhelp
--repo—Start the search for the repository root here (default: the current directory)
--discovery—How declarative files are enumerated
--strict—Refuse to proceed when any file of the layer carries an error diagnostic
--share—The tool distribution's share directory (kinds.yaml, schemas/); default: $MAJORDOMUS_SHARE, then the repository's own share/, then the one beside the executable
--host—Interface to bind; without it, the one `MAJORDOMUS_HTTP_HOST` names on this machine, and loopback (`127.0.0.1`) when that is unset
--port—Port to bind; without it, the port this checkout derives (8741 for the primary checkout); 0 picks a free one and the address is logged on stderr
--fallback—When the port is taken, bind a free one instead and log both; without this a taken port is an error
--idle—Stop when no peer has been attached for this many seconds; 0 runs until stopped. What a server no client owns is started with
--deployment—Bind the address this deployment object declares (`.ai/repo/deployments/<ID>.yaml`) instead of the local default. What a hosted process is started with; the address is the object's, not this command line's