khalidsaidi

Relayorb — Testing skill for Claude Code

Testing community

Flight recorder for AI agents: record, replay & regression-test MCP server tool calls from Claude Code, Cursor, Codex & Claude Desktop.

How to install Relayorb

This entry records only its repository, not the path inside it, so there is no exact command to give. Open khalidsaidi/relayorb and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Relayorb does

Flight recorder for AI agents: record, replay & regression-test MCP server tool calls from Claude Code, Cursor, Codex & Claude Desktop.

Alternatives in Testing

  • Spec Kitty — Spec-Driven Development for serious software developers 1.6k ★
  • Spec Driven Develop — Spec-driven development workflow for AI coding agents: architecture-first planning, task decomposition, GitHub 975 ★
  • Test TDD — Run when user calls /test-tdd 957 ★

README

RelayOrb

**Turn real AI agent sessions into tests for MCP servers.**

RelayOrb records the messages between an AI agent (Claude Code, Cursor, Codex, Claude Desktop) and an MCP server. Save a recording, and RelayOrb can:

  • Check every new build of your MCP server against it in CI, and fail if any answer changed (relayorb check).
  • Replay it in place of the real server, so agent tests run offline with the same answers every time (relayorb replay).
  • Show the raw JSON-RPC traffic when a tool call goes wrong: every request, response, error, and latency (relayorb show).

**Who it's for:** people who build MCP servers (the main use), people who build agents or apps on top of MCP tools, and anyone who needs the exact protocol messages to debug a tool call.

**When you don't need it:** if you only want to see what your agent did once, Claude Code, Cursor, and other agent apps already show tool calls. RelayOrb also only works with local (stdio) MCP servers, not remote HTTP ones.

It's a single local binary. No account, no cloud, no telemetry, and free (Apache-2.0).

Website: https://relayorb.com

Install

cargo install --git https://github.com/khalidsaidi/relayorb relayorb

Prebuilt binaries for Linux, macOS, and Windows are attached to each [GitHub release](https://github.com/khalidsaidi/relayorb/releases).

Record

Put `relayorb record --` in front of any stdio MCP server command. For example, in Claude Desktop's `claude_desktop_config.json` (Cursor and other MCP clients use the same shape):

{
  "mcpServers": {
    "filesystem": {
      "command": "relayorb",
      "args": ["record", "--name", "fs", "--", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/Users/me/notes"]
    }
  }
}

With Claude Code:

claude mcp add fs -- relayorb record --name fs -- npx -y @modelcontextprotocol/server-filesystem ~/notes

The agent works exactly as before, because bytes are forwarded unchanged in both directions. Eac