Crate agent_relay 

agent-relay

Agent-to-agent messaging for AI coding tools.

When multiple AI agents (Claude, Gemini, GPT, Copilot) or human developers work on the same codebase, they need a way to coordinate. agent-relay provides instant, file-based messaging with zero setup — no server, no database, no config.

Quick Start

use std::path::PathBuf;
use agent_relay::Relay;

let relay = Relay::new(PathBuf::from(".relay"));

// Register this agent
relay.register("claude-opus", "session-1", std::process::id());

// Send a message
relay.send("session-1", "claude-opus", None, "refactoring auth module — stay away from src/auth/");

// Another agent checks inbox
let msgs = relay.inbox("session-2", 10);
for (msg, is_new) in &msgs {
    if *is_new {
        println!("[{}] {}: {}", msg.from_agent, msg.from_session, msg.content);
    }
}

CLI

# Register yourself
agent-relay register --agent claude --session my-session

# Send a broadcast
agent-relay send "heads up: changing the auth module"

# Send to specific agent
agent-relay send --to session-2 "can you review src/auth.rs?"

# Check inbox
agent-relay inbox

# List active agents
agent-relay agents

Originally extracted from Aura, the semantic version control engine.

Modules

client

HTTP client for connecting to a remote relay server.

daemon

Persistent daemon that polls for messages and spawns AI agents.

git

Git-integrated identity, SSH signing, and collaborator verification.

hub

Hub: auth, teams, channels, and invite logic for agent-relay.

server

HTTP relay server with SQLite persistence.

server_service

Install the relay server as a persistent system service.

Structs

AgentRegistration

Message

Relay

The main relay hub. All operations are local filesystem — no network.