Command line for the Optimi platform API. Sign in with your Optimi account, pick a tenant and call the API from a terminal.
- Download the archive for your system from the latest release (macOS or Linux, amd64 or arm64) and the checksums file.
- Verify it:
- macOS:
shasum -a 256 -c optictl_<version>_checksums.txt --ignore-missing - Linux:
sha256sum -c optictl_<version>_checksums.txt --ignore-missing
- macOS:
- Extract it and put
optictlon your PATH:tar -xzf optictl_<version>_<os>_<arch>.tar.gz && install -m 0755 optictl_<version>_<os>_<arch>/optictl /usr/local/bin/optictl
optictl auth login # opens your browser; --no-browser prints the URL
optictl whoami # identity, selected tenant, granted scopes
optictl tenant list # tenants you may use
optictl tenant use acme # remembered per user and API
optictl api /hosts # call any /v1 operation
optictl auth logoutCredentials are stored in the macOS Keychain or the Linux Secret Service. Without a desktop keyring (CI, containers) set OPTICTL_CREDENTIAL_STORE=file to use a 0600 file under ~/.config/optictl.
Environment: OPTICTL_API_URL (default https://dash.optimi.com), OPTICTL_CREDENTIAL_STORE (keyring or file), OPTICTL_CONFIG_DIR.
Sign-in uses a local callback on 127.0.0.1 ports 52790-52794; one of them must be free. Binaries are not signed or notarized yet, so verify the checksum.
This repository only hosts releases. Report problems to your Optimi contact.