Expand description
oxibrain serve — start the MCP server (DESIGN §12.4).
Default transport is stdio (what Claude Desktop expects). --socket <path>
listens on a Unix-domain socket for the daemon topology (§4.3): several apps
share one brain through the single-writer store actor (P8).
--socket <path> --require-token gates each connection behind a token
handshake (§11.2). --http <addr> serves loopback HTTP.
--daemon writes a PID file to <dir>/.oxibrain.pid so external supervisors
(launchd) can manage the process. When --socket is omitted and
--daemon is set, the daemon binds the Oxi Foundation default socket
($OXIBRAIN_SOCKET if set, otherwise $HOME/.oxi/brain/oxibrain.sock).
Without --daemon, an omitted --socket keeps stdio as the transport.
The binary never forks — backgrounding is the supervisor’s job (§15). All
socket/HTTP listeners shut down gracefully on SIGINT/SIGTERM.