Session Relay

本地服务

relay.rahulweb.online开发工具53 天前更新

代码仓库访问官网

关于 Session Relay

Session Relay 用于在团队成员之间交接 Claude Code、Codex、OpenCode 等编码 Agent 的会话，保留目标、决策、后续步骤和近期对话。它提供 CLI、Agent 命令和团队自托管服务。

主要功能

01跨编码 Agent 分享会话
02按成员交接并恢复工作
03搜索、查看和评论共享会话
04附加未提交更改或 PR
05本地脱敏并预览上传内容

适用场景

01将任务交给使用不同 Agent 的队友
02恢复团队成员之前的工作上下文
03在 PR 上分享会话并附上更改
04检查会话上传内容是否含敏感信息

MCP 相关

通过 relay setup 将 MCP 服务和 /share、/pickup 命令接入已安装的 Agent；Agent 启动 relay mcp。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ryrahul-session-relay": {
      "command": "npx",
      "args": [
        "-y",
        "session-relay"
      ],
      "env": {
        "RELAY_SERVER": "<RELAY_SERVER>",
        "RELAY_TOKEN": "<RELAY_TOKEN>"
      }
    }
  }
}

启动命令npx -y session-relay

需要配置的环境变量

RELAY_SERVERURL of your team's Session Relay server. Optional if you ran relay login.

RELAY_TOKEN密钥Personal access token (srk_...) from Settings → Tokens. Optional if you ran relay login.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmsession-relay0.7.0stdio

工具

收录的工具列表 · 更新于 3 天前

参数	类型	必填	说明
file	string	否	仅列出涉及此文件的会话（路径的一部分也可以）
tool	enum	否	仅列出来自此编码 Agent 的会话claude-code \| codex \| opencode \| zcode \| gemini \| copilot \| cursor
limit	integer	否	返回数量，按时间从新到旧排列（默认 10）
author	string	否	姓名、电子邮箱或 "me"
branch	string	否	仅列出从此 Git 分支共享的会话
for_me	boolean	否	仅列出分配给你的交接
all_repos	boolean	否	列出所有仓库的会话，而不仅是当前仓库

详细介绍

session-relay

在 Claude Code、Codex、OpenCode、Gemini CLI、Copilot CLI、Cursor 和 ZCode 之间与团队共享编码 Agent 会话。在一个 Agent 中运行 /share；队友在他们使用的任意 Agent 中运行 /pickup，即可继续推进目标、决策、后续步骤和近期对话。

npm install -g session-relay
relay login --server https://relay.your-team.com   # approve in the browser
relay setup     # adds the relay MCP server and /share, /pickup to your agents

然后，在你的 Agent 中：

/share
/share for bob
/pickup
/pickup alice's webhook retry work

你需要为团队部署一个 Session Relay 服务；请参阅自托管。云托管即将推出。

命令


`relay sessions`	此仓库的本地 Agent 会话
`relay share [--dry-run]`	选择会话、选择要包含的内容以及查看对象
`relay share --diff`	附加未提交的更改；队友在运行 `relay pull` 后使用 `git apply` 应用这些更改
`relay share --for <name>`	为队友创建交接（也可使用 `--pr <url>`；系统会自动查找分支的 PR）
`relay list`、`relay search "<q>"`	共享的会话。可使用 `--for-me`、`--file <path>`，或在查询中使用 `file:` / `branch:`
`relay show <id>`、`relay pull <id>`	阅读会话，或写入 `.relay/handoff-<id>.md` 供你的 Agent 使用
`relay edit <id>`	修改你的共享内容：标题、摘要、后续步骤、接收对象、PR
`relay pr-comment <id>`	在会话对应的拉取请求中发布会话
`relay setup --auto-share on`	在每次 Claude Code、Gemini CLI 和 Copilot CLI 会话结束时，将其保存为私人草稿；运行 `relay publish <id>` 即可共享
`relay template`	此仓库的交接模板
`relay export <id>`、`relay export --all`	下载一个会话（Markdown/JSON）或多个会话（NDJSON）
`relay setup --tools gemini`	连接之后安装的某个 Agent
`relay digest`、`relay stats`	查看团队近期工作；查看团队统计数据
`relay comment <id> "<text>"`	在会话中留言（下一个 Agent 会读取）
`relay delete <id>`	删除你的共享内容
`relay members`、`relay invite --link`	查看团队成员；创建邀请链接（管理员）
`relay setup`	连接已安装的所有 Agent
`relay mcp`	Agent 启动的 MCP 服务