CLI¶

The Orion CLI is a Python command-line tool built with Typer that provides full control over the Orion platform through the gateway API. It handles authentication, trend management, content workflows, provider switching, and system administration — all from your terminal.

Installation¶

The CLI is a uv workspace member. Install and run from the cli/ directory:

cd cli
uv sync
uv run orion --help

Or use the Makefile:

make cli-dev ARGS="--help"

Global Options¶

These options are available on every command:

Configuration is stored in ~/.orion/config.toml:

gateway_url = "http://localhost:8000"

Output formats¶

# Default table output (human readable, uses Rich)
orion scout list-trends

# JSON output (for scripting and piping to jq)
orion scout list-trends --format json

# Plain output (tab-separated values)
orion scout list-trends --format plain

Table output example:

auth — Authentication¶

Manage your session with the Orion gateway. The CLI stores JWT tokens in ~/.orion/token.

orion auth login¶

Interactive login. Prompts for email and password, obtains a JWT token from the gateway, and stores it locally.

orion auth login
# Email: admin@orion.local
# Password: ****
# Logged in successfully

orion auth logout¶

Clear stored credentials.

orion auth logout
# Credentials cleared.

orion auth whoami¶

Display current authentication state.

orion auth whoami

system — System Health & Status¶

Monitor the Orion platform.

orion system health¶

Check health of all services.

orion system health

orion system status¶

Show system overview — mode, GPU availability, queue depth.

orion system status

scout — Trend Detection¶

Trigger scans, query detected trends, and manage Scout service configuration.

orion scout list-trends¶

List trends detected by previous scans.

orion scout list-trends
orion scout list-trends --format json

JSON output:

orion scout trigger¶

Trigger an immediate trend scan.

orion scout trigger
orion scout trigger --format json

orion scout configure¶

Configure the active niche for trend scanning.

orion scout configure tech
orion scout configure gaming --format json

content — Content Management¶

Manage the full content lifecycle — list, inspect, approve, reject, regenerate.

orion content list¶

orion content list
orion content list --format json

orion content view <id>¶

orion content view abc-123
orion content view abc-123 --format json

orion content approve <id>¶

orion content approve abc-123

orion content reject <id>¶

orion content reject abc-123

pipeline — Pipeline Runs¶

View and manage content pipeline executions.

orion pipeline status
orion pipeline run <trend-id>
orion pipeline logs

publish — Publishing & Social Accounts¶

Manage social media accounts and publishing.

orion publish accounts
orion publish history

admin — Admin Operations¶

Administrative operations like seeding and cleanup.

orion admin seed
orion admin cleanup
orion admin cleanup --days 30
orion admin seed-demo

Development¶

# Run CLI tests
make cli-test

# Lint CLI code
make cli-lint

# Build distributable wheel
make cli-build