RelayCore CLI

The official command-line interface for RelayCore, the agentic finance infrastructure on Cronos. This tool scaffolds projects, manages identities, and spins up local development environments for autonomous agents.

📚 Full Documentation: docs.relaycore.xyz/cli

Features

- 🚀 Scaffold Projects: Generate production-ready Agent, Service, or Full-Stack templates.
- 🔐 Identity Management: Register agents and services on-chain (Cronos).
- 🛠️ Local Development: Run a full local stack with MCP server, Next.js dashboard, and hot-reloading.
- 🤖 MCP Integration: Built-in support for Model Context Protocol servers.

Installation

``bash
npm install -g @relaycore/cli

or via pnpm


pnpm add -g @relaycore/cli
`

Quick Start

$3

Create a new agent project with a standard directory structure:

`bash
relaycore init my-agent


Select template: Agent (MCP), Service (Express), or Full Stack


cd my-agent
`

$3

Authenticate your machine to interact with the RelayCore network:

`bash
relaycore auth login


Opens browser to authenticate and saves session


`

$3

Before you can transact, your agent needs an on-chain identity (Relay ID):

`bash


Register an Agent (Consumer)

relaycore agent register

Prompts for: Name, Description, Capabilities

Register a Service (Provider)

relaycore service register

Prompts for: Service Category, Input/Output Schemas, Price

`

$3

Run your agent locally with the RelayCore harness:

`bash
relaycore dev
`
This command:
- Starts your MCP Server (port 3001)
- Luanches the Relay Dashboard (port 3000)
- Connects to Cronos Testnet via your local wallet configuration
- Watches for file changes

Commands Reference

$3


`bash
relaycore init
`
Scaffolds a new project. You will be prompted to choose a template:
- Agent: Minimal MCP server template.
- Service: Express.js service provider template.
- Full: Monorepo with both + Next.js frontend.

$3

`bash
relaycore auth login # Login via web
relaycore auth logout # clear local session
relaycore auth whoami # Show current user details
`

$3

`bash
relaycore agent register # Interactively register new agent
relaycore agent list # List agents owned by you
relaycore agent update # Update metadata for existing agent
`

$3

`bash
relaycore service register # Register new service
relaycore service list # List your services
`

$3

Create x402-protected proxy routes for any API endpoint.

`bash
relaycore route add # Create a new paid proxy route
relaycore route list # List your routes with earnings
relaycore route remove # Remove a route
relaycore route test # Test a route (shows 402 requirements)
`

Example: Make any API paid
`bash
relaycore route add \
--url https://api.example.com/data \
--price 0.01 \
--name "Data API"

Output:

Route Created Successfully

Proxy URL: https://api.relaycore.xyz/proxy/abc123

`

Requests to the proxy URL require x402 payment before being forwarded to the upstream API.

$3

`bash
relaycore dev
`
Starts the development studio. Requires a valid relaycore.config.ts in the project root.

Configuration

The CLI looks for a .env file in your project root for local overrides:

`bash
RELAY_API_URL=https://api.relaycore.xyz # Default
RELAY_ENV=testnet # default: testnet
PRIVATE_KEY=... # Optional: For script deploy
``

License

MIT