Integrations

CLI

The Humiris 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 Humiris CLI
npm install -g humiris

# Verify installation
humiris --version

Authentication

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

bash

# Log in with your API key
humiris auth login

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

# Check authentication status
humiris 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
humiris create alex-sdr \
  --first-name Alex \
  --last-name Rivera \
  --email \
  --phone

# Create with all identity primitives
humiris 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
humiris 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
humiris info alex-sdr

Provision additional primitives

bash

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

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

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

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

Send messages

bash

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

# Send an SMS
humiris 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
humiris config set output json

# Set default workspace
humiris config set workspace acme

# View current configuration
humiris config list

# Configuration file location
# macOS: ~/.config/humiris/config.json
# Linux: ~/.config/humiris/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.