regentx

Agent management CLI (eigenx fork) for factory + ERC-8004 workflows

regentx is Regent’s agent management CLI (based on an eigenx fork) for:

• Creating agents via the on-chain factory

• Querying agent state (factory + ERC-8004)

• Managing agent lifecycle (pause/resume/transfer as implemented)

• Bootstrapping local project config (regent.config.ts)

Source: monorepo/regent-cli/packages/regentx/

Install / run

# one-off
bunx @regent/regentx@latest --help

# global
bun add -g @regent/regentx@latest
regentx --help

Quick start

# 1) Create a regent.config.ts in the current directory
regentx agent:init --name "my-agent"

# 2) (optional) create .env from .env.example and set PRIVATE_KEY for on-chain mode
#
# 3) Create an agent
regentx agent:create --mode mock

# 4) Inspect status
regentx agent:status

Commands

regentx agent:init

Scaffolds regent.config.ts (+ .env.example if missing).

regentx agent:init [options]

Common options:

• --name <name>: agent name

• --chain <chain>: default chain ID or name

• --owner-wallet <id>: wallet connector ID (default: local-eoa)

• --metadata-uri <uri>: initial metadata URI

• --mode <mode>: mock or onchain (default: mock)

• --yes: overwrite existing config

regentx agent:create

Creates a new agent via the factory (or an in-memory factory in mock mode).

regentx agent:create [options]

Common options:

• --mode <mode>: mock or onchain

• --dry-run: print what would happen without sending transactions

• --json: machine-readable output

regentx agent:status

Shows on-chain and ERC-8004 state for an agent.

regentx agent:status [agentId] [options]

• agentId defaults to config.state.agentId when present.

regentx agent:list

Lists agents owned by a wallet.

regentx agent:list [options]

Common options:

• --owner <address>: override owner address

• --limit <n>: max agents (default: 50)

• --json: machine-readable output

Global options

Available on all commands:

--config <path>       Path to config file (default: ./regent.config.ts)
--chain <chain>       Chain ID or name (sepolia, base-sepolia, etc.)
--rpc-url <url>       Override RPC URL
--wallet <id>         Wallet connector ID
--factory <address>   Override factory address
--mode <mode>         Deployment mode: mock or onchain

Configuration file

regentx agent:init writes a regent.config.ts that looks like:

import { defineConfig } from '@regent/regentx';

export default defineConfig({
  version: 1,
  agent: {
    name: 'My Regent Agent',
    ownerConnectorId: 'local-eoa',
    metadata: { uri: 'ipfs://QmYourMetadataHash' },
    deploymentMode: 'mock', // or 'onchain'
    erc8004: { chainId: 11155111 }, // optional
    tokenomics: { rakeBps: 500 }, // optional
  },
});

Environment variables

On-chain mode requires a signing key:

PRIVATE_KEY=0x...

Optional overrides:

RPC_URL=https://...
FACTORY_ADDRESS=0x...
SUBGRAPH_URL=https://...   # if using ERC-8004 subgraph queries
PINATA_JWT=...             # if publishing metadata via IPFS pinning

Related docs

• Regent SDK

• ERC-8004 integration guide