Olakai CLI

Command-line interface tool for the Olakai platform. Designed for managing Olakai configuration and inspecting AI activity.

Installation

npm install -g olakai-cli

Usage

olakai <command> [options]

Commands

Authentication

olakai login              # Login via browser (OAuth 2.0 Device Flow)
olakai logout             # Clear credentials
olakai whoami             # Show current user

Agents

olakai agents list [--json] [--include-kpis]
olakai agents get <id> [--json]
olakai agents create --name <name> [--description <desc>] [--role <WORKER|COORDINATOR>] [--with-api-key]
olakai agents update <id> [--name <name>] [--description <desc>]
olakai agents delete <id> --force

Workflows

olakai workflows list [--json] [--include-agents]
olakai workflows get <id> [--json]
olakai workflows create --name <name> [--description <desc>]
olakai workflows update <id> [--name <name>] [--description <desc>]
olakai workflows delete <id> --force

KPIs

olakai kpis list [--agent-id <id>] [--json]
olakai kpis get <id> [--json]
olakai kpis create --name <name> --calculator <formula|classifier|llm-data> [--formula <expr>]
olakai kpis update <id> [--name <name>]
olakai kpis delete <id> --force
olakai kpis validate --formula <expr> [--agent-id <id>]
olakai kpis context-variables [--agent-id <id>]

Custom Data

Manage custom data configurations for KPI formula variables:

olakai custom-data list [--json]
olakai custom-data get <id> [--json]
olakai custom-data create --name <name> --type <STRING|NUMBER|BOOLEAN> [--description <desc>]
olakai custom-data update <id> [--name <name>] [--type <type>] [--description <desc>]
olakai custom-data delete <id> --force

Custom data fields allow you to send arbitrary metrics from your SDK integration that can be used as variables in KPI formulas. The --name must exactly match the key used in your SDK's customData object.

Activity

Inspect AI activity and prompt requests:

# List prompt requests with filters
olakai activity list [--agent-id <id>] [--workflow-id <id>] [--since <date>] [--until <date>] [--limit <n>] [--offset <n>] [--include-content] [--include-analytics] [--json]

# Get single prompt request details
olakai activity get <id> [--include-content] [--json]

# Get aggregated KPI values
olakai activity kpis --agent-id <id> | --workflow-id <id> [--since <date>] [--until <date>] [--period <hourly|daily|weekly>] [--include-atoms] [--json]

Environment

Set environment with -e flag or OLAKAI_ENV variable:

• production (default): https://app.olakai.ai
• staging: https://staging.app.olakai.ai
• local: http://localhost:3000

Example:

olakai -e local login
# or
OLAKAI_ENV=local olakai login

Development

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Run linting
pnpm lint

# Type check
pnpm type-check

Requirements

• Node.js v20 or higher
• pnpm v10 or higher