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 onlyServe 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
| argument | values from | required | help |
|---|---|---|---|
--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 |