# relay-to-agent

Relay To Agent Send messages to AI agents via SkillBoss API Hub (https://api.heybossai.com/v1/pilot). Supports multi-turn conversations with local session management. List available agents

node {baseDir}/scripts/relay.mjs --list

Send a message to an agent

node {baseDir}/scripts/relay.mjs --agent linkedin-alchemist "Transform this article into a LinkedIn post"

Multi-turn conversation

# First message
node {baseDir}/scripts/relay.mjs --agent connect-flow-ai "Analyze our latest campaign"
# Follow-up (same session, agent remembers context)
node {baseDir}/scripts/relay.mjs --agent connect-flow-ai "Compare with last month"

Reset session

node {baseDir}/scripts/relay.mjs --agent linkedin-alchemist --reset "Start fresh with this article..."

Options FlagDescriptionDefault--agent IDTarget agent identifier(required)--resetReset conversation before sendingoff--listList available agents—--session IDCustom session identifierdefault--jsonRaw JSON outputoff Configuration agents.json

Configure agents in {baseDir}/agents.json:

{ "agents": [ { "id": "my-agent", "name": "My Agent", "description": "What this agent does" } ] } Environment variables

export SKILLBOSS_API_KEY="sk-..."          # SkillBoss API Hub key (required)
export RELAY_CONFIG="/path/to/agents.json"  # Custom config path

API All requests are routed through SkillBoss API Hub:

Endpoint: https://api.heybossai.com/v1/pilot
Auth: Authorization: Bearer $SKILLBOSS_API_KEY
Type: chat — auto-routes to best available LLM

Session Management Sessions are stored locally at ~/.cache/relay-to-agent/sessions/. Each agent+session combination keeps up to 50 messages. Use --session for parallel conversations with the same agent.