CLI Reference¶
Global flags¶
These flags are available on all commands:
--config string Config file path
--state-dir string State directory path
--socket-path string gRPC unix socket path
--interval duration Reconciliation interval
--api-addr string API gateway gRPC address
--log-level string Log level (debug, info, warn, error)
--log-format string Log format (json, text)
segla run¶
Start the agent daemon. This is the main command used in production.
The agent will:
- Load or create local state
- Register with the platform (if not already registered)
- Start the reconcile loop
- Listen on the unix socket for local CLI commands
segla status¶
Show the current agent status.
Connects to the running agent via the unix socket and displays registration state, last reconcile time, and resource status.
segla state¶
Inspect the local bbolt state database.
Useful for debugging — shows the raw persisted state including agent ID, resource data, and last applied desired state.
segla inventory¶
Display machine inventory information.
Shows the hardware and OS information that the agent reports to the platform during registration.
segla version¶
Print the agent version, commit hash, and build date.
Example output: