cli

CLI tool for scaffolding agent projects with templates and framework adapters.

Installation

# Create a new agent project
bunx @regent/cli my-agent

# Or install globally
bun add -g @regent/cli
regent my-agent

Quick Start

# Interactive wizard
bunx @regent/cli my-agent

# With specific template
bunx @regent/cli my-agent --template=identity

# Non-interactive
bunx @regent/cli my-agent --template=blank --non-interactive

Command Options

Option	Description
--template, -t	Select template
--adapter, -a	Select framework adapter
--install, -i	Run bun install after scaffolding
--no-install	Skip dependency installation
--wizard=no	Skip interactive wizard
--non-interactive	Non-interactive mode
--network	Set payment network
--KEY=value	Pass template arguments

Adapters

hono

Lightweight HTTP agent using Hono framework.

bunx @regent/cli my-agent --adapter=hono

express

Node.js-compatible agent using Express.js.

bunx @regent/cli my-agent --adapter=express

tanstack-ui

Full-stack agent with TanStack Start and React UI.

bunx @regent/cli my-agent --adapter=tanstack-ui

Features:

• TanStack Router (file-based routing)

• TanStack Query (data fetching)

• Tailwind CSS styling

• Wallet integration (Reown AppKit)

• Pre-built dashboard UI

tanstack-headless

API-only agent using TanStack Start.

bunx @regent/cli my-agent --adapter=tanstack-headless

next

Full-stack agent using Next.js App Router.

bunx @regent/cli my-agent --adapter=next

Templates

blank

Minimal agent with basic configuration.

bunx @regent/cli my-agent --template=blank

axllm

Agent with LLM integration (@ax-llm/ax).

bunx @regent/cli my-agent --template=axllm

axllm-flow

Agent with multi-step LLM workflows.

bunx @regent/cli my-agent --template=axllm-flow

identity

Agent with ERC-8004 on-chain identity.

bunx @regent/cli my-agent --template=identity

Features:

• On-chain identity registration

• Trust metadata configuration

• ERC-8004 registry integration

trading-data-agent

Merchant agent providing trading data.

bunx @regent/cli my-agent --template=trading-data-agent

trading-recommendation-agent

Shopper agent consuming trading data.

bunx @regent/cli my-agent --template=trading-recommendation-agent

Network Selection

# EVM testnets
bunx @regent/cli my-agent --network=base-sepolia

# EVM mainnets
bunx @regent/cli my-agent --network=base

# Solana
bunx @regent/cli my-agent --network=solana-devnet
bunx @regent/cli my-agent --network=solana

Non-Interactive Mode

Pass template arguments directly:

bunx @regent/cli my-agent \
  --template=identity \
  --non-interactive \
  --AGENT_DESCRIPTION="My Agent" \
  --AGENT_VERSION="1.0.0" \
  --PAYMENTS_RECEIVABLE_ADDRESS="0x..." \
  --AGENT_WALLET_PRIVATE_KEY="0x..." \
  --install

Generated Project Structure

my-agent/
├── src/
│   ├── agent.ts          # Agent configuration
│   └── index.ts          # HTTP server
├── .env                  # Environment variables
├── .env.example          # Template reference
├── package.json          # Dependencies
├── tsconfig.json         # TypeScript config
└── README.md             # Documentation

Environment Variables

Common Variables

AGENT_NAME=my-agent
AGENT_VERSION=0.1.0
AGENT_DESCRIPTION=Your agent description
PAYMENTS_FACILITATOR_URL=https://facilitator.regent.cx
PAYMENTS_RECEIVABLE_ADDRESS=0x...
PAYMENTS_NETWORK=base-sepolia

Identity Template

AGENT_DOMAIN=agent.example.com
IDENTITY_AUTO_REGISTER=true
RPC_URL=https://sepolia.base.org
CHAIN_ID=84532
AGENT_WALLET_PRIVATE_KEY=0x...

AxLLM Templates

OPENAI_API_KEY=sk-...
AX_MODEL=gpt-4o
AX_PROVIDER=openai

Project Scripts

{
  "scripts": {
    "dev": "bun run --watch src/index.ts",
    "start": "bun run src/index.ts",
    "build": "bun build src/index.ts --outdir=dist",
    "type-check": "tsc --noEmit"
  }
}

Examples

Create Hono Agent with Identity

bunx @regent/cli verified-agent \
  --adapter=hono \
  --template=identity \
  --network=base-sepolia \
  --install

Create Express Agent with LLM

bunx @regent/cli ai-agent \
  --adapter=express \
  --template=axllm \
  --install

Create Next.js Dashboard Agent

bunx @regent/cli dashboard-agent \
  --adapter=next \
  --template=blank \
  --install

CI/CD Pipeline

bunx @regent/cli production-agent \
  --template=identity \
  --non-interactive \
  --AGENT_DESCRIPTION="Production Agent" \
  --PAYMENTS_NETWORK=base \
  --PAYMENTS_RECEIVABLE_ADDRESS="${WALLET_ADDRESS}" \
  --AGENT_WALLET_PRIVATE_KEY="${PRIVATE_KEY}" \
  --install

TEE Deployment

The Regent CLI includes TEE deployment capabilities built on EigenX for sovereign agent deployment.

Deploy to TEE

# Deploy current project to TEE
regent deploy --tee

# With specific configuration
regent deploy --tee \
  --image ghcr.io/myorg/myagent:v1 \
  --chain base-sepolia \
  --with-token

What TEE Deployment Does

1. Builds Docker image - Packages your regent-sdk agent

2. Deploys to Confidential VM - Intel TDX / AMD SEV via dstack/Phala

3. Provisions deterministic wallet - TEE-only mnemonic derivation

4. Deploys on-chain contracts:

   • AGENT-N token (per-agent ERC-20)

   • Agent Treasury (x402 payments land here)

   • Bond & Staking vaults

5. Registers identity - ERC-8004 with endpoints, wallet, and capabilities

TEE Options

Option	Description
--tee	Enable TEE deployment
--image	Docker image to deploy
--chain	Target blockchain
--with-token	Deploy AGENT-N token
--key-path	Custom key derivation path

TEE Environment Variables

# TEE Configuration
TEE_PROVIDER=phala
TEE_KEY_PATH=regent/agents/myagent/wallet

# On-chain Configuration
CHAIN_ID=84532
RPC_URL=https://sepolia.base.org

# Token Configuration (optional)
DEPLOY_AGENT_TOKEN=true
PROTOCOL_FEE_PERCENT=2

Full TEE Deployment Example

# 1. Create agent with identity template
bunx @regent/cli sovereign-agent \
  --template=identity \
  --adapter=hono \
  --install

# 2. Configure environment
cd sovereign-agent
cp .env.example .env
# Edit .env with your configuration

# 3. Deploy to TEE with token
regent deploy --tee --with-token

# Output:
# ✓ Built Docker image: ghcr.io/myorg/sovereign-agent:v1
# ✓ Deployed to TEE (instance: tee-abc123)
# ✓ Wallet derived: 0x1234...
# ✓ AGENT-N token deployed: 0xABCD...
# ✓ Treasury deployed: 0xEFGH...
# ✓ Bond vault deployed: 0xIJKL...
# ✓ Registered in ERC-8004: 84532:42
#
# Agent is live at: https://sovereign-agent.regent.cx
# Agent ID: 84532:42

See TEE Infrastructure for architecture details and TEE Deployment Example for complete walkthrough.