Applications
Applications are OAuth clients authorized to connect to Chronicle. They represent non-human principals — services, workers, or CI pipelines — that authenticate using client credentials rather than a username and password. Applications are distinct from users: a user logs in interactively, while an application uses a client ID and secret to obtain tokens programmatically.
Lists all OAuth client applications registered on the Chronicle server.
cratis chronicle applications listExamples
Section titled “Examples”List all registered applications:
cratis chronicle applications listList in plain format:
cratis chronicle applications list --output plainRegisters a new OAuth client application with the specified client ID and secret.
cratis chronicle applications add <CLIENT_ID> <CLIENT_SECRET>Arguments
Section titled “Arguments”| Argument | Description |
|---|---|
CLIENT_ID | The client identifier for the application. |
CLIENT_SECRET | The client secret the application uses to authenticate. |
Examples
Section titled “Examples”Register a new application:
cratis chronicle applications add my-service my-secret-valueSecurity note
Section titled “Security note”Avoid passing secrets as shell arguments in environments where command history is logged. Use environment variables or a secrets manager to supply the secret value, then pass it via a variable:
cratis chronicle applications add my-service "$APP_SECRET"remove
Section titled “remove”Removes a registered application from Chronicle. This operation is irreversible. Any service using the removed application’s credentials will immediately lose access.
cratis chronicle applications remove <APP_ID>The command prompts for confirmation before proceeding. Pass --yes to skip the prompt in automated workflows.
Arguments
Section titled “Arguments”| Argument | Description |
|---|---|
APP_ID | The GUID of the application to remove. Use applications list to retrieve application IDs. |
Options
Section titled “Options”| Flag | Description |
|---|---|
-y, --yes | Skip confirmation prompt. |
Examples
Section titled “Examples”Remove an application interactively:
cratis chronicle applications remove a1b2c3d4-e5f6-7890-abcd-ef1234567890Remove without confirmation:
cratis chronicle applications remove a1b2c3d4-e5f6-7890-abcd-ef1234567890 --yes