CLI Reference

The MeetLoyd CLI (@meetloyd/cli) provides command-line access to platform features for automation, scripting, and quick operations.

The package provides three binaries:

Binary	Description
meetloyd	Full CLI with all commands
ml	Shorthand alias for meetloyd
loyd	Interactive Loyd chat mode (separate entry point)

Installation

npm install -g @meetloyd/cli
# or
bun add -g @meetloyd/cli

Authentication

# Login with API key as argument
meetloyd login sk_live_xxxxx

# Login with custom base URL
meetloyd login sk_live_xxxxx --url https://app.meetloyd.com

# With environment variable (no login command needed)
export MEETLOYD_API_KEY=sk_live_xxxxx

# Check current identity
meetloyd whoami

# Logout
meetloyd logout

Global Options

Option	Description
-o, --output <format>	Output format: json, yaml, table, human (default: human)
-V, --version	Show CLI version
-h, --help	Show help

Agents

meetloyd agents list                                       # List all agents
meetloyd agents get <id>                                   # Get agent details
meetloyd agents create --name "Support" --model claude-sonnet-4-6 --system-prompt "..."
meetloyd agents execute <id> "Summarize today's tickets"   # Execute agent with a message
meetloyd agents execute <id> "Hello" --no-stream           # Execute without streaming
meetloyd agents delete <id>                                # Delete (with confirmation)
meetloyd agents delete <id> --force                        # Delete (skip confirmation)
meetloyd agents pause <id>                                 # Pause an agent
meetloyd agents resume <id>                                # Resume a paused agent

Chat (Conversations)

The chat command group manages interactive conversations with agents:

meetloyd chat start <agent-id>                             # Start a new conversation
meetloyd chat send <conversation-id> "Your message"        # Send a message (streams response)

Tasks

meetloyd tasks list                          # List all tasks
meetloyd tasks list --status running         # Filter by status
meetloyd tasks get <id>                      # Get task details
meetloyd tasks create --name "Report" --agent-id <id>
meetloyd tasks run <id>                      # Run a task
meetloyd tasks cancel <id>                   # Cancel a running task
meetloyd tasks delete <id>                   # Delete a task
meetloyd tasks logs <id>                     # View task logs

Workflows

meetloyd workflows list                      # List all workflows
meetloyd workflows get <id>                  # Get workflow details
meetloyd workflows run <id> --input '{"key": "value"}'
meetloyd workflows pause <id>
meetloyd workflows activate <id>
meetloyd workflows delete <id>
meetloyd workflows runs <id>                 # List workflow runs
meetloyd workflows run-status <workflow-id> <run-id>
meetloyd workflows cancel-run <workflow-id> <run-id>

Teams

meetloyd teams list
meetloyd teams get <id>
meetloyd teams create --name "Engineering"
meetloyd teams delete <id>
meetloyd teams add-member <team-id> <user-id> --role member
meetloyd teams remove-member <team-id> <user-id>
meetloyd teams set-role <team-id> <user-id> admin

Templates

meetloyd templates list --category support
meetloyd templates get <id>
meetloyd templates deploy <id> --name "My Agent" --config '{"key": "value"}'
meetloyd templates categories
meetloyd templates delete <id>

Manifests

meetloyd manifest validate <file>            # Validate a manifest file
meetloyd manifest resolve <file>             # Resolve versions (dry run)
meetloyd manifest deploy <file>              # Deploy a team from manifest
meetloyd manifest deploy <file> --dry-run    # Preview without deploying
meetloyd manifest list                       # List deployments
meetloyd manifest get <id>                   # Get deployment details
meetloyd manifest export <id>               # Export as manifest file
meetloyd manifest upgrade <id>              # Upgrade components
meetloyd manifest rollback <id> -c <ref> -v <version>

Memory

meetloyd memory info                         # Memory system info
meetloyd memory create --agent-id <id> --content "..." --type fact
meetloyd memory search "query" --agent-id <id>
meetloyd memory list <agent-id>
meetloyd memory stats <agent-id>
meetloyd memory delete <memory-id>
meetloyd memory delete-all <agent-id>

# Quick store helpers
meetloyd memory fact <agent-id> "Company was founded in 2025"
meetloyd memory preference <agent-id> "Prefers concise answers"
meetloyd memory instruction <agent-id> "Always include sources"

# Team memory
meetloyd memory team list <team-id>
meetloyd memory team get <team-id> <key>
meetloyd memory team set <team-id> <key> <value>
meetloyd memory team delete <team-id> <key>

# A2A conversation management
meetloyd memory a2a status <conversation-id>
meetloyd memory a2a leave <conversation-id>
meetloyd memory a2a rejoin <conversation-id>

# Storage configuration
meetloyd memory storage config
meetloyd memory storage set --type s3 --config '{"bucket": "..."}'

Schedules

meetloyd schedules list
meetloyd schedules get <id>
meetloyd schedules create --name "Daily" --cron "0 9 * * *" --timezone "Europe/Paris" --target-type agent --target-id <id>
meetloyd schedules pause <id>
meetloyd schedules resume <id>
meetloyd schedules trigger <id>              # Manually trigger
meetloyd schedules delete <id>

Triggers

meetloyd triggers list
meetloyd triggers get <id>
meetloyd triggers enable <id>
meetloyd triggers disable <id>
meetloyd triggers test <id> --payload '{"event": "test"}'
meetloyd triggers delete <id>

Tools

meetloyd tools list
meetloyd tools get <id>
meetloyd tools builtins                      # List built-in tools
meetloyd tools test <id> --input '{"key": "value"}'
meetloyd tools delete <id>

API Keys

meetloyd api-keys list
meetloyd api-keys create --name "Production" --scopes "agents:read,agents:write"
meetloyd api-keys rotate <id>
meetloyd api-keys delete <id>

Store

meetloyd store browse
meetloyd store get <listing-id>
meetloyd store stats
meetloyd store install <listing-id>
meetloyd store uninstall <listing-id>
meetloyd store installed                     # List installations
meetloyd store reviews <listing-id>
meetloyd store review <listing-id>           # Create a review

Usage & Billing

meetloyd usage summary                       # Usage summary (default)
meetloyd usage daily --days 14               # Daily breakdown
meetloyd usage agents                        # Per-agent usage

meetloyd billing subscription                # Current subscription
meetloyd billing plans                       # Available plans
meetloyd billing usage                       # Billing usage
meetloyd billing invoices                    # List invoices
meetloyd billing payment-methods             # List payment methods

Governance

# Kill switch (emergency controls)
meetloyd governance kill-switch check
meetloyd governance kill-switch action --target-type agent --target-id <id> --action pause
meetloyd governance kill-switch history

# Prompt versioning
meetloyd governance versions create --agent-id <id> --system-prompt "..."
meetloyd governance versions production <agent-id>
meetloyd governance versions history <agent-id>
meetloyd governance versions promote <version-id> --environment production

# A/B testing
meetloyd governance ab-tests create --agent-id <id> --control-version-id <id> --treatment-version-id <id>
meetloyd governance ab-tests get <agent-id>
meetloyd governance ab-tests complete <test-id> --winner control

Other Command Groups

The CLI also includes commands for:

• meetloyd avatars -- Manage AI avatars (create, generate video, check status)
• meetloyd voice -- Voice synthesis (TTS) and recognition (STT)
• meetloyd streaming -- Data streaming pipelines
• meetloyd budgets -- Cost and usage budget management
• meetloyd dlp -- Data Loss Prevention configuration
• meetloyd cot -- Chain-of-thought logging
• meetloyd governance integrations -- Governance integrations (PagerDuty, ServiceNow)
• meetloyd compliance -- Compliance frameworks, reports, evidence
• meetloyd lifecycle -- First-start orchestration, charters, handshakes
• meetloyd security-center -- Security dashboard and controls
• meetloyd access-reviews -- Access review management
• meetloyd sso -- SSO/SAML configuration
• meetloyd audit -- Audit logs, SIEM integrations, hash chain verification
• meetloyd incidents -- Incident management, security alerts, change requests
• meetloyd oasf -- OASF agent discovery metadata
• meetloyd analytics -- Dashboard, time series, costs, errors, patterns
• meetloyd notifications -- Notification preferences and push subscriptions
• meetloyd webhooks -- Webhook CRUD, deliveries, testing
• meetloyd integrations -- OAuth integration catalog, connections
• meetloyd files -- File upload, download, parse, security scan
• meetloyd models -- List models, capabilities, cost calculation

Run meetloyd <command> --help for detailed usage of any command group.

Setup & Status

meetloyd init                                # Interactive setup wizard
meetloyd status                              # Show CLI configuration status

Shell Completions

meetloyd completions bash >> ~/.bashrc
meetloyd completions zsh >> ~/.zshrc
meetloyd completions fish > ~/.config/fish/completions/meetloyd.fish

Environment Variables

Variable	Description
MEETLOYD_API_KEY	API key for authentication
MEETLOYD_BASE_URL	API base URL

Scripting

Use the --output json flag for machine-readable output:

# Get agent ID from creation
meetloyd agents create --name "Test" --output json | jq -r '.id'

# Pipe operations
meetloyd agents list --output json | jq -r '.agents[].id'

---

Need help? Run meetloyd --help or meetloyd <command> --help for detailed command information.