iai

iai

InteractiveAI's CLI

Synopsis

InteractiveAI's CLI to interact with its platform.

Use the subcommands below to manage your organizations, projects, agents, services, secrets, prompts, routines, policies, variables, glossaries, macros, and other components.

Install

The CLI is distributed through Go's package manager, so it must first be installed. Click on this link and follow the instructions to do so.

To validate the installation run:

go version

Once Go is installed, ensure Go binaries are in your PATH:

export PATH=$PATH:$(go env GOPATH)/bin

Add this line to your shell profile (~/.bashrc, ~/.zshrc, etc.) to make it permanent.

Now install InteractiveAI's CLI with the following command:

go install github.com/Interactive-AI-Labs/interactive-cli/cmd/iai@latest

Verify the installation by running:

iai --help

---

Structured output

Many commands support --json and --yaml for automation. Human-readable table/detail output is the default.

For API-backed commands such as traces, observations, datasets, queues, scores, and sessions, structured output preserves the API envelope:

{
  "success": true,
  "data": {
    "traces": []
  }
}

Use the resource under data as the stable payload, for example:

iai traces list --json | jq '.data.traces[]'
iai traces get <trace-id> --yaml

Prompt resources (prompts, routines, policies, variables, glossaries, macros, skills) expose structured output on list and describe/get. List output is wrapped as:

{
  "prompts": [],
  "totalCount": 0
}

Options

      --api-key string               API key for authentication
      --cfg-file string              Path to YAML config file with organization, project, and optional service definitions
      --deployment-hostname string   Hostname for the deployment API (default "https://deployment.interactive.ai")
  -h, --help                         help for iai
      --hostname string              Hostname for the API (default "https://app.interactive.ai")

SEE ALSO

• iai agents - Deploy AI agents with policies, routines, and tools

• iai api-keys - Project API keys

• iai collections - Knowledge bases (searchable tables of chunks) inside a pgvector database

• iai comments - Annotate traces, observations, and sessions

• iai completion - Generate the autocompletion script for the specified shell

• iai databases - PostgreSQL instances with extension support, including pgvector

• iai dataset-items - Manage items in evaluation datasets

• iai dataset-runs - Run evaluations against datasets

• iai datasets - Create and list evaluation datasets

• iai glossaries - Domain vocabularies for consistent term interpretation

• iai images - Manage container images

• iai login - Authenticate with InteractiveAI

• iai logout - Clear local session

• iai macros - Pre-approved response templates used in routines

• iai mcps - Deploy and manage MCP servers

• iai metrics - Query aggregated observability metrics

• iai observations - Inspect spans within traces

• iai organizations - Switch or list organizations

• iai policies - Single-step behavioral rules for agents

• iai projects - Switch or list projects

• iai prompts - Versioned prompts for agents, evaluators, and guardrails

• iai queue-items - Manage items in annotation queues

• iai queues - Annotation queues for human review workflows

• iai replicas - Inspect service replicas

• iai router - Inspect the inference router, keys, and models

• iai routines - Multi-step behavioral processes for agents

• iai run-items - Inspect results of evaluation runs

• iai score-configs - Define scoring schemas for evaluation

• iai scores - Read and write evaluation scores

• iai secrets - Encrypted key-value pairs for services and agents

• iai services - Deploy and manage HTTP services

• iai sessions - Browse trace-derived conversation sessions

• iai skills - Manage Interactive Copilot skills (not to be confused with context items that configure the Interactive Agent)

• iai stacks - Declarative resource sync from config files

• iai traces - Browse agent decision traces with full attribution

• iai update - Update iai to the latest version

• iai variables - Contextual attributes referenced in policies and routines