flowlayer-server

flowlayer-server is the runtime source of truth.

Usage

flowlayer-server [-c <path>] [--config <path>] [<path>] [-s <bind>] [-token <value>] [--no-color] [-h|--help] [--version]

Options

Flag	Meaning
-c <path>	Config file path
--config <path>	Config file path (same effect as -c)
<path>	Positional config path (only one allowed)
-s <bind>	Enable Session API on host:port or :port
-token <value>	Session bearer token
--no-color	Disable ANSI colors
-h, --help	Print help
--version	Print version

-v is not supported.

Config path resolution

Priority order:

1. -c <path>
2. --config <path>
3. positional <path>
4. auto-discovery in current directory:
   • flowlayer.jsonc
   • flowlayer.json
   • flowlayer.config.jsonc
   • flowlayer.config.json

Using both -c and --config is an error.

Session bind notes

• -s 6999 resolves to 127.0.0.1:6999
• -s :6999 binds all interfaces
• port must be between 1 and 65535

When session API is enabled and no token is provided, server auto-generates one.

Common invocations

flowlayer-server -c ./flowlayer.jsonc
flowlayer-server ./flowlayer.jsonc
flowlayer-server -c ./flowlayer.jsonc -s 127.0.0.1:6999 -token dev-token

Exit code semantics

• 0: success, help, or version
• 2: CLI usage error (unknown flags, bad argument shape, config selection conflict)
• 1: runtime or startup failure after argument parsing

Related docs: Config Overview, HTTP API Overview, Server and TUI Modes.