Integrations

CLI

The Iris CLI lets you create and manage agent identities directly from your terminal. Provision email, phone, wallet, and other primitives without writing any code.

Installation

Install the CLI globally via npm. It requires Node.js 18 or later.

bash

# Install the Iris CLI
npm install -g iris

# Verify installation
iris --version

Authentication

Authenticate with your API key. The CLI stores your credentials securely in your system keychain.

bash

# Log in with your API key
iris auth login

# Or set the key directly
export IRIS_API_KEY=hum_sk_live_...

# Check authentication status
iris auth whoami

Commands

The CLI provides commands for the full agent lifecycle: creation, listing, provisioning, and deletion.

Create an agent

bash

# Create a new agent with email and phone
iris create alex-sdr \
  --first-name Alex \
  --last-name Rivera \
  --email \
  --phone

# Create with all identity primitives
iris create full-agent \
  --first-name Jordan \
  --last-name Chen \
  --email \
  --phone \
  --wallet ethereum,solana \
  --computer \
  --browser \
  --card visa

List agents

bash

# List all agents in your workspace
iris list

# Output:
# SLUG            EMAIL                         PHONE           STATUS
# alex-sdr        alex-sdr@acme.humiris.com     +14155550142    active
# full-agent      full-agent@acme.humiris.com   +14155550198    active

# Get detailed info for a specific agent
iris info alex-sdr

Provision additional primitives

bash

# Add email to an existing agent
iris provision email alex-sdr

# Add a phone number
iris provision phone alex-sdr --country US

# Add a wallet
iris provision wallet alex-sdr --chain ethereum

# Add a virtual card
iris provision card alex-sdr --network visa

Send messages

bash

# Send an email
iris email send alex-sdr \
  --to customer@example.com \
  --subject "Hello from Alex" \
  --body "Just checking in!"

# Send an SMS
iris sms send alex-sdr \
  --to +14155559876 \
  --body "Meeting confirmed for 3pm."

Configuration

The CLI reads configuration from environment variables and a local config file. You can set defaults for workspace, output format, and other options.

bash

# Set default output format
iris config set output json

# Set default workspace
iris config set workspace acme

# View current configuration
iris config list

# Configuration file location
# macOS: ~/.config/iris/config.json
# Linux: ~/.config/iris/config.json

Next steps

Try MCP (Claude Code) integration for AI-native workflows. Generate an API Key to authenticate the CLI. See the API Reference for the complete list of available operations.