CLI

Reference documentation for the arctl command-line interface.

The arctl command-line interface (CLI) is the primary tool for managing agents, MCP servers, skills, and prompts in AgentRegistry.

Installation

Download and install the arctl CLI from the GitHub releases page:

OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')

gh release download v2026.7.0 \
  --repo solo-io/agentregistry-enterprise \
  --pattern "arctl-${OS}-${ARCH}" \
  --output arctl
chmod +x arctl
sudo mv arctl /usr/local/bin/arctl

Quick start

# Scaffold a new agent project
arctl init agent my-agent

# Run the agent locally
arctl run ./my-agent

# Apply resources to the registry
arctl apply -f my-agent/agent.yaml

# List all agents
arctl get agents

Commands

Command	Description
arctl	Main command and global flags
arctl apply	Apply one or more resources from a YAML file
arctl build	Build a Docker image for a declarative resource project
arctl delete	Delete a registry resource
arctl get	List or retrieve registry resources
arctl init	Scaffold a new resource project with declarative YAML
arctl pull	Fetch a registry resource’s source repo to local
arctl run	Run the agent or MCP server in the current directory
arctl runtime	Runtime bootstrap helpers
arctl user	User management (login, logout, whoami)
arctl configure	Configure client connections
arctl completion	Generate shell autocompletion scripts
arctl version	Display version information

Environment variables

You can configure arctl using the following environment variables:

Variable	Description
`ARCTL_API_TOKEN`	Registry bearer token for authentication
`ARCTL_API_BASE_URL`	Registry base URL (default: http://localhost:12121)

Global flags

All commands support the following global flags:

-h, --help: Display help information for the command.
--registry-token string: Registry bearer token (overrides ARCTL_API_TOKEN).
--registry-url string: Registry URL (overrides ARCTL_API_BASE_URL; default http://localhost:12121).

Changelogs Helm