Straion CLI (Early Access)

Note: This CLI is currently in early access. Features may change and we appreciate your feedback. For questions or issues, please contact [email protected].

███████╗████████╗██████╗  █████╗ ██╗ ██████╗ ███╗   ██╗
██╔════╝╚══██╔══╝██╔══██╗██╔══██╗██║██╔═══██╗████╗  ██║
███████╗   ██║   ██████╔╝███████║██║██║   ██║██╔██╗ ██║
╚════██║   ██║   ██╔══██╗██╔══██║██║██║   ██║██║╚██╗██║
███████║   ██║   ██║  ██║██║  ██║██║╚██████╔╝██║ ╚████║
╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝ ╚═════╝ ╚═╝  ╚═══╝

The Missing Piece for AI-Era Software Engineering at Scale

The Straion CLI provides command-line access to the Straion platform, enabling seamless integration with AI coding agents and developer workflows.

Installation

# npm
npm install -g @straion/cli

# pnpm
pnpm install -g @straion/cli

Requirements

• Node.js 22.0.0 or higher

Quick Start

# Display the welcome screen (includes first-time setup wizard on first run)
straion

# Or authenticate with your Personal Access Token
# This stores login information securely and makes it available on your machine.
straion login

# Set up your coding agents to use Straion
straion setup

Commands

| Command | Description | | ------------------- | --------------------------------------------------------------------------------------------------- | | straion | Display the welcome screen with status (first-time setup wizard on first run) | | straion login | Authenticate with a Personal Access Token. Accepts --token <token> and --org <subdomain> flags. | | straion logout | Log out and clear stored credentials | | straion setup | Set up your coding agents to use Straion | | straion switch | Switch your active organization. Accepts --org <subdomain> for non-interactive switching. | | straion --help | Show all available commands | | straion --version | Display the current version |

Authentication

The CLI accepts two kinds of Access Tokens:

• Personal access token — represents you as user. Can be used across every organization you belong to. Generate one in your user settings.
• Organization access token — represents one organization, not a user. Pinned to that organization for the lifetime of the token. Best for CI and other unattended environments.

To log in interactively:

straion login
# or with the token inline:
straion login --token <your_personal_access_token>

Credentials are encrypted and stored under ~/.straion/credentials.enc.

Environment variables (CI / unattended use)

| Variable | Purpose | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | STRAION_API_KEY | Token used for the invocation. Works with both user and organization access tokens. Never written to ~/.straion/. | | STRAION_ORG_ID | (User access tokens only.) Selects which organization to operate against. Accepts the org id or subdomain. Ignored for organization access tokens (those are pinned to one org by the token itself). |

# User access token — defaults to the token owner's default organization
export STRAION_API_KEY=<user_pat>
straion find-rules --title "..."

# User access token + explicit org
export STRAION_API_KEY=<user_pat>
export STRAION_ORG_ID=<org-subdomain-or-id>
straion find-rules --title "..."

# Organization access token — org is fixed to the token's organization
export STRAION_API_KEY=<org_pat>
straion find-rules --title "..."

Agent Setup

The straion setup command helps you configure your coding agents to work with Straion. It downloads the necessary skills and plugins, then guides you through selecting which agents to configure.

Supported Agents

| Agent | Description | | -------------- | ---------------------------- | | Claude Code | Anthropic's CLI for Claude | | GitHub Copilot | GitHub's AI coding assistant | | Cursor | AI-powered code editor |

Run straion setup to interactively set up your preferred agents, or run straion for the first-time setup wizard which includes agent configuration.

Multi-Organization Support

If you belong to multiple organizations, the CLI allows you to switch between them:

# Interactive org selector
straion switch

# Direct switch by subdomain
straion switch --org <subdomain>

The subdomain is the prefix of your organization URL (e.g. acme for acme.straion.app).

You can also select an organization during login:

straion login --org <subdomain>

Learn More

Visit https://www.straion.com for additional information.