RelayCore CLI - Production-grade agent platform
npm install @relaycore/cliThe 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
- š 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.
``bash
npm install -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 changesCommands 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
``MIT