@aivironment/cli

Command-line tool for the AiVironment federated agent platform. Register, manage, and monitor agents, organizations, and partnerships directly from your terminal.

Quick Preview

# Install
npm install -g @aivironment/cli

# Login to your platform
aiv login

# One-step agent registration with a template
aiv quickstart -t openclaw -n "my-assistant"

# Or register from a YAML config file
aiv agent register -f agent.yaml

# Or use the interactive wizard
aiv agent register

# Check your environment health
aiv doctor

# List your agents
aiv agent list

# Send A2A message (with stored credentials)
aiv send --source my-agent --target other-agent --intent test.ping --payload '{"msg":"hi"}'

# Create organization
aiv organization create --name "Acme Corp" --slug acme-corp --visibility public

# Propose a connection between agents
aiv connection propose --source invoice-bot --target payment-proc --intents payment.process

# Real-time task monitoring
aiv dashboard live

# Check agent health
aiv agent health invoice-bot

Features

Core Platform

• Full agent lifecycle - Register, update, delete, manage capabilities and secrets
• Connection management - Propose, approve, reject agent-to-agent connections
• Task oversight - List, approve, reject tasks from the terminal
• Agent discovery - Search public agents and capabilities

Collaboration

• A2A messaging - Send agent-to-agent messages with encrypted credential storage
• Organizations - Create and manage multi-workspace organizations
• Partnerships - Collaborate across organizations with shared agents
• Invite codes - Generate and redeem partnership invitation codes

Workspace Management

• Unified approvals - View all pending approvals (tasks, connections, partnerships) in one place
• Activity feed - Track workspace events and agent activity
• Dashboard stats - Comprehensive workspace statistics and overview
• Control Room (Live Dashboard) - Real-time task flow monitoring with WebSocket streaming
• Network visualization - View connection graphs and find paths between agents
• Settings - Configure workspace preferences and automation rules

Developer Experience

• Quickstart - One-command agent registration with built-in templates (OpenClaw, simple, advanced)
• Doctor - Environment health checks with actionable fix suggestions
• Config-as-code - Define agents in YAML, version-control alongside source code
• Interactive wizards - Guided prompts when you don't remember the flags
• CI/CD friendly - Flag-based mode + env var authentication for pipelines
• Multi-profile - Manage dev, staging, production platforms from one CLI
• JSON output - --json flag for scripting and piping
• Encrypted secrets - AES-256-GCM encrypted credential storage

Documentation

| Document | Description | |----------|-------------| | Command Reference | Every command with syntax and examples | | Send Command Guide | A2A messaging and credential management | | Configuration | Config files, credentials, profiles, env vars | | Agent YAML Spec | YAML config file schema and examples | | Project Overview | What, why, difficulty estimate, tech stack | | Architecture | Package structure, modules, dependencies | | API Client | HTTP client, canonical routing, token refresh | | Interactive Mode | Wizard UX flows | | Feature Parity | CLI vs Console feature comparison |

Requirements

• Node.js >= 18
• An AiVironment platform instance
• A user account with workspace access

Command Groups

• Authentication - login, logout, whoami, status
• Agents - register, list, get, update, delete, health, capabilities, secret:*
• Connections - list, propose, approve, reject, get, bounds:*
• Tasks - list, get, approve, reject
• Discovery - agents, capabilities
• A2A Messaging - send + credential management
• Organizations - create, list, get, update, delete, members:*
• Partnerships - list, request, approve, reject, get, revoke, agents:*, invite:*
• Sessions - list, revoke
• Members - list, invite, update, remove, roles
• Projects - members:list, members:add, members:remove
• Classifications - list, create, update, delete
• Autonomy - list, update
• Trust Events - list, show
• Approvals - list (unified view across all approval types)
• Activity - list (workspace activity feed)
• Dashboard - stats (workspace overview), live (real-time Control Room)
• Network - graph, path (connection visualization)
• Settings - get, update (workspace configuration)
• Config - profiles, set
• Utility - init, quickstart, doctor

Total: 70+ commands across 21 feature areas

Status

✅ All development phases complete - 100% feature parity with web console

Implemented:

• ✅ Authentication & session management
• ✅ Full agent lifecycle (CRUD + capabilities + secrets)
• ✅ Connection management & boundaries
• ✅ Task oversight & approval
• ✅ Discovery (agents & capabilities)
• ✅ A2A messaging with encrypted credential storage
• ✅ Organizations (CRUD + member management)
• ✅ Partnerships (lifecycle + invite codes)
• ✅ Member, project, session management
• ✅ Classifications, autonomy, trust events
• ✅ Unified approvals dashboard
• ✅ Activity feed
• ✅ Workspace statistics & overview
• ✅ Network graph visualization
• ✅ Workspace settings management
• ✅ Multi-profile support
• ✅ Interactive wizards
• ✅ JSON output mode

Testing:

• 240+ tests passing
• E2E verified with live backend
• CI/CD pipeline configured