Command guide

Every SMART command, explained.

Use this reference to understand what a command changes, then copy the exact form you need.

Authentication

Personal account

Sign in through your browser. SMART keeps your session in the operating system credential store.

Headless access

Use client credentials for unattended tools and automation. No background service is needed.

Sign in through the system browser using PKCE. Personal credentials stay in the operating system credential store. Remove the selected headless credentials file before browser or device sign-in.

Print a verification URL and one-time code (plus a QR in an interactive terminal), then wait for you to approve sign-in in a browser on any device.

Verify a confidential client and save its client ID, secret and deployment profile in the selected credentials file. Replace CLIENT_ID and SECRET with provisioned values. The command uses the deployment built into this CLI.

Use an explicit absolute credentials-file path instead of the home file. Repeat this option for commands that should use that file; a missing or invalid selected file reports an error.

Renew the selected session. Personal login uses coordinated refresh-token rotation; headless mode obtains a new client-credentials grant.

Show the selected authentication mode and verified identity. A temporary personal-session recovery error can be retried without another sign-in.

With a selected headless file, delete that file and leave personal credentials unchanged. Otherwise sign out of the personal session. Headless logout does not revoke the client secret at the identity provider.