The sky CLI is the typed terminal interface for the Interactions control plane. Manage projects, Skyline users, platforms, and your developer profile without opening the dashboard.

Install

npx @interactions-hq/cli login
npm install -g @interactions-hq/cli
sky login
bun add -g @interactions-hq/cli
sky login
Requires Node.js 18+ or Bun 1.0+.

Quickstart

# 1. Log in (opens browser for device approval)
sky login

# 2. Pick a project
sky projects ls
export INTERACTIONS_PROJECT_ID=<project-id>

# 3. Manage Skyline
sky skyline users ls
sky skyline platforms enable imessage

Environment variables

VariableDescription
INTERACTIONS_API_HOSTAPI base URL (default https://app.interactions.co.in)
INTERACTIONS_PROJECT_IDActive project for Skyline commands
INTERACTIONS_TOKENOverride stored session token
INTERACTIONS_CONFIG_DIRConfig directory (default ~/.config/interactions)
For hackathon projects, set INTERACTIONS_API_HOST to the host your organizer provides.

The skyline alias

skyline is a shortcut for sky:
skyline users ls    # sky skyline users ls
skyline whoami

Common flags

FlagEnv varDescription
-p, --project <id>INTERACTIONS_PROJECT_IDTarget project
--api-host <url>INTERACTIONS_API_HOSTOverride backend URL
-t, --token <token>INTERACTIONS_TOKENUse this token instead of stored credentials
--jsonOutput as JSON (where supported)