English Français العربية

Code Relay

السجل الرسمي أدوات المطورين

Branch-scoped runbooks, remote checkpoints, and auditable verification receipts.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package code-relay-mcp
Claude Code 
claude mcp add code-relay -- npx -y code-relay-mcp@3.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "code-relay": {
            "command": "npx",
            "args": [
                "-y",
                "code-relay-mcp@3.1.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Code Relay
  2. Build. Prove. Relay.
  3. When Relay is useful
  4. What Relay provides
  5. Quick start
  6. MCP server details
  7. How it works
  8. Documentation
  9. License

Code Relay

English · Chinese

Build. Prove. Relay.

Code Relay lets your coding agent develop on one machine and prove the result on another.

Relay is an MCP-based coding-agent integration for cross-machine development and verification. AI on the Dev Host implements the request; the Target Host runs the real validation; a structured receipt comes back to guide the next repair iteration. It works with Codex, Claude Code, Cursor, VS Code, and other MCP-capable coding agents.

When Relay is useful

  • Different environments — develop on Windows or macOS, verify on Linux, a private network, or a production-like host.
  • Special hardware — send model code to a CUDA/GPU machine, or verify a camera, serial device, or sensor where it is connected.
  • Real integrations — exercise payment callbacks, queues, databases, browsers, or internal services that cannot be reproduced locally.
  • AI-driven iteration — return concrete expected/actual results so the coding agent can repair, republish, and retry.

What Relay provides

  • Branch-scoped project binding and short-lived join links.
  • Exact source-commit verification in an isolated worktree.
  • Checkpoint execution through a code-relay-checkpoint GitHub Actions self-hosted runner.
  • Safe, allowlisted validation commands with bounded output and timeouts.
  • Structured receipt.json and human-readable receipts for passed, failed, and blocked runs.

Quick start

AI client installation

Let your coding agent read and follow the instructions:

https://raw.githubusercontent.com/zarcherlot/code-relay/main/install.md
npm fallback
npx -y code-relay-mcp@latest install --client codex

Replace codex with claude-code, cursor, vscode, or generic as needed.

MCP server details

Code Relay is a local MCP server that communicates over stdio. The npm package starts the server with:

npx -y code-relay-mcp@3.1.0

The server implements the MCP JSON-RPC surface directly in Go (without a third-party MCP SDK). It supports initialize, ping, tools/list, and tools/call, and exposes these tools:

ToolPurpose
bind_projectBind a repository and branch to a relay role.
create_checkpoint_inviteCreate a short-lived checkpoint join link.
join_checkpointJoin a branch-scoped checkpoint subscription.
watcher_statusRead local watcher state.
stop_watcherStop the local watcher.
doctorRun non-mutating local health checks.
publish_runbookValidate and publish a runbook.
statusRead runbook and receipt status.
fetch_receiptLoad and validate a runbook receipt.
analyzeAnalyze a receipt and determine the next state.

The implementation and transport loop are in internal/relay/mcp.go.

How it works

the Dev Host sends a repository- and branch-bound runbook through Relay; the Target Host checks the exact source commit in its real environment and returns a Receipt recording the Checkpoint result.

Every runbook is bound to a repository, branch, and source commit. The Target Host acts as the Checkpoint, and the resulting receipt records passed, failed, or blocked verification for the next iteration.

Documentation

License

Code Relay is released under the MIT License.

الأسئلة الشائعة

ما هو Code Relay؟

Branch-scoped runbooks, remote checkpoints, and auditable verification receipts.

كيف أثبّت Code Relay؟

يعمل على جهازك. في Claude Code: claude mcp add code-relay -- npx -y code-relay-mcp@3.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Code Relay إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Code Relay مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Code Relay؟

ينشره zarcherlot. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.