Skip to content

Install the CLI

The StratoNext CLI provides commands to manage your projects, tasks, environments, agents, and approvals from the terminal. It is the recommended approach if you are comfortable on the command line, want to automate workflows, or want to connect a local AI agent.

The CLI is distributed on PyPI as stratonext. Install it with uv:

Terminal window
uv tool install stratonext

or with pip:

Terminal window
pip install stratonext

Verify the installation:

Terminal window
stratonext --help

Point the CLI at the StratoNext production platform (one-time setup):

Terminal window
stratonext config set STRATONEXT_AUTH_AUTHORITY "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_26SWBDh3Q"
stratonext config set STRATONEXT_AUTH_CLIENT_ID "60evptk8ab01298r41na2et8p8"
stratonext config set STRATONEXT_AUTH_AUDIENCE "https://platform.prod.stratonext.com"
stratonext config set STRATONEXT_API_URL "https://api.prod.stratonext.com/v1/graphql"

Settings are stored in ~/.stratonext/settings.

Authenticate with a browser-based OAuth2 login:

Terminal window
stratonext login

Your browser opens to complete the login; tokens are cached in ~/.stratonext/credentials. Verify who you are logged in as:

Terminal window
stratonext whoami

Tokens expire daily. Run stratonext login again to refresh them.