Choose a command family
Server and storage
Launch, status, stop, restart, update and offline store maintenance.
Authoring and deployment
New, generate, check, package, deploy, run and every AWL verb.
Workers
Serve shell, AWL and agent workers; inspect and control the managed fleet.
Runs and routing
Start, signal, query, inspect and control executions and package routes.
Global options
Operate Aion workflows over gRPC and run the Aion workflow server. Bare `aion` starts the server in the background and opens the ops console.
aion [OPTIONS] [COMMAND]-
--endpoint <ENDPOINT> - gRPC address for client operations. A missing scheme means http://. Set server listeners through server configuration or --grpc-address.
-
--namespace <NAMESPACE> - Workflow namespace used for operations [default: default]
-
--subject <SUBJECT> - Caller subject metadata sent to the server [default: cli-user]
-
--token <TOKEN> - Bearer token for authenticated servers. Overrides the `AION_TOKEN` environment variable; when both are absent the development header paths apply
-
--pretty - Print formatted, human-readable JSON
-
--foreground - Bare `aion` only: run the launched server in this terminal instead of the background
-
--no-open - Bare `aion` only: do not open the ops console in a browser
-
-h, --help - Print help (see a summary with '-h')
-
-V, --version - Print version
The endpoint is a gRPC dial address. When omitted by a client operation it resolves to the local endpoint. A server bind address comes from server configuration or its listener flags.
The bare launcher alone accepts foreground and no-open options. Server control verbs act on the local Aion home, not an arbitrary remote endpoint.
For interactive help, append the help flag to a command, or pass the command path to the generated help subcommand.
Exit codes
-
0 - The command completed successfully. For server status, the recorded process identity is verified and serving; also read readiness.
-
1 - A client/local operation failed. For update, an attempted update did not finish. For server status, the recorded server has stopped or failed its serving check.
-
2 - Clap argument error or server configuration/control refusal. Server status uses 2 when it could not complete its check.
-
130 - Forced server shutdown after a second termination signal.
Use your installed command’s help to check availability before applying a main-only option.