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.

Install

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

uv tool install stratonext

or with pip:

pip install stratonext

Verify the installation:

stratonext --help

Log in

Authenticate with a browser-based OAuth2 login:

stratonext login

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

stratonext whoami

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

Run it without a browser

stratonext login is the interactive path and acts as you. For CI/CD, scheduled automation, or any host without a browser, the CLI can instead authenticate as a registered agent. There is no login step: set the agent’s client credential in that process’s environment.

export STRATONEXT_AUTH_API_CLIENT_ID="agtc_..."
export STRATONEXT_AUTH_API_CLIENT_SECRET="..."

In that mode it draws short-lived environment credentials from StratoNext rather than needing cloud keys of its own. Running as an agent is for hosts with nobody at the keyboard. It is not a way for a person to reach a cloud account: signed in as yourself, you use your own cloud credentials. See Operating modes.

Next steps

• Install the agent skill to drive StratoNext from Claude Code, Codex, or any coding agent. This is the recommended path: it covers every command.
• Connect an MCP host if you would rather give the agent a smaller, work-focused set of typed tools instead of the full command surface.
• Connect an Account to unlock resource discovery and delegated operations.