@agentium/cli

Build, test, and publish AI agents to the Agentium Exchange.

Installation

npm install -g @agentium/cli

Requires Node.js 18 or later.

Quick Start

# Create a new agent project
agentium init my-agent

# Start the local dev server
cd my-agent
agentium dev

# Run test fixtures
agentium test

# Validate and bundle
agentium build

# Publish to the Agentium Exchange
agentium login
agentium publish

Commands

Command	Description
agentium init [name]	Create a new agent project from a template
agentium dev	Start local dev server with playground UI at localhost:4200
agentium test	Run test fixtures defined in agent.yaml
agentium build	Validate agent.yaml, check security, and bundle
agentium publish	Publish agent to the Agentium Exchange
agentium validate	Validate agent.yaml without building
agentium login	Authenticate via OAuth 2.0 Device Flow
agentium logout	Log out of your Agentium account
agentium whoami	Show current authenticated user

Templates

Template	Description
typescript-minimal	Minimal TypeScript agent with MCP support
python-minimal	Minimal Python agent
langchain	LangChain-based agent (Python)
crewai	CrewAI multi-agent setup
docker	Docker-based agent with custom runtime
mcp-server	Model Context Protocol server
a2a-agent	Agent-to-Agent protocol agent

Use --template to skip the interactive prompt:

agentium init my-agent --template typescript-minimal

Agent Manifest (agent.yaml)

Every agent project requires an agent.yaml file following the Agent Packaging Standard (APS) v0.1:

aps: "0.1"
name: my-agent
version: "1.0.0"
description: "What your agent does"

author:
  name: "Your Name"
  email: "you@example.com"

runtime:
  engine: node          # node | python | docker | wasm
  entry: src/index.ts

protocols:
  - mcp                 # mcp | a2a | rest | grpc

capabilities:
  - name: my-capability
    description: "What this capability does"

pricing:
  model: free           # free | per-request | subscription | usage-based

testing:
  fixtures:
    - name: "basic test"
      input: { "message": "hello" }
      expected_output_contains: ["hello"]

Authentication

The CLI uses OAuth 2.0 Device Flow for secure authentication:

agentium login

This opens your browser for authentication. Credentials are stored in ~/.agentium/config.json.

Configuration

CLI configuration is stored at ~/.agentium/config.json:

{
  "api_url": "https://api.agentium.space",
  "registry_url": "https://registry.agentium.space"
}

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT

---

agentium.space — The AI Agent Infrastructure Exchange