CLI Overview

The agentverse CLI is your primary tool for interacting with any AgentVerse server — publishing artifacts, searching the registry, managing social features, and more.

Global Flags

Every command supports these top-level flags:

Flag	Env Var	Default	Description
--server <URL>	AGENTVERSE_URL	http://localhost:8080	Server base URL
--token <TOKEN>	AGENTVERSE_TOKEN	(saved config)	Bearer token for auth

# Override per-command
agentverse --server https://registry.example.com --token $MY_TOKEN search "..."

# Or set globally via env
export AGENTVERSE_URL=https://registry.example.com
export AGENTVERSE_TOKEN=eyJ...

Command Groups

Group	Commands	Description
Discovery	search, get, list, versions	Find and inspect artifacts
Publishing	publish, update, fork, deprecate	Manage artifacts
Auth	register, login, whoami	Account management
Social	comment, like, unlike, rate, stats	Community features
Agent	learn, benchmark	Machine-to-machine operations
Self	self-update	Update the CLI binary

Quick Reference

# Discovery
agentverse search "code review"
agentverse get skill/myorg/my-skill
agentverse get skill/myorg/my-skill@1.2.0      # pinned version
agentverse list skill
agentverse versions skill/myorg/my-skill

# Publishing
agentverse publish                              # uses ./agentverse.toml
agentverse publish path/to/manifest.toml
agentverse publish --bump minor --changelog "Added X"
agentverse publish --zip skill.zip             # upload package archive

# Auth
agentverse register myuser --email me@example.com
agentverse login myuser
agentverse whoami

# Social
agentverse like skill/myorg/my-skill
agentverse unlike skill/myorg/my-skill
agentverse rate skill/myorg/my-skill 5 --review "Excellent!"
agentverse comment skill/myorg/my-skill "Great work!"
agentverse stats skill/myorg/my-skill

# Agent (M2M)
agentverse learn skill/myorg/my-skill --insight "Works great for Python 3.12+" --confidence 0.9
agentverse benchmark agent/myorg/my-agent --score 0.92

# Self-management
agentverse self-update

Sections

• Installation — Download, install, and build from source
• Configuration — CLI config file and environment variables
• Authentication — Register, login, and token management
• Discovery Commands — search, get, list, versions
• Publishing Commands — publish, update, fork, deprecate
• Social Commands — comment, like, rate, stats
• Agent Commands — learn, benchmark