Session Relay

io.github.Ryrahul由 GitHub 账号 Ryrahul 发布v0.7.0更新于 Oct 26, 2026

Share coding-agent sessions with your team: /share in one agent, /pickup in another.

已验证STDIO仅桌面开发者工具沟通与协作

概览

AI 生成的概览

在团队之间共享编码代理会话，让助手交接工作、接手他人的会话，并实时协作。

可以做什么
  • 列出和搜索共享会话，包括指派给你的交接，以及按文件或分支筛选
  • 以交接形式加载共享会话，按不同详细程度读取摘要、决策、后续步骤和对话
  • 按仓库的交接模板分享当前会话，并更新或评论已有的分享
  • 读取队友附加在会话上的未提交改动 diff
  • 查看团队近期动态，以及谁正在实时工作、涉及哪些文件
  • 启动、发送消息、收取收件箱、更新和结束实时会话
适用场景
适合多人或多个代理在相同仓库上协作、需要在 Claude Code、Codex、Gemini CLI、Copilot CLI、Cursor 等代理之间传递工作的团队，或需要并行工作时保持同步的场景。
运行要求
以本地 npm 包 session-relay 通过 stdio 运行，需全局安装并用 relay 命令行完成设置。需要团队自有的 Session Relay 服务器，通过 RELAY_SERVER 环境变量提供或经 relay login 保存；若未登录还需在 RELAY_TOKEN 中提供个人访问令牌。仅支持桌面端。
安装前请注意
共享的会话、评论和实时消息会上传到团队服务器，其中的内容队友可见；工具提示不要包含机密，README 称凭据会在上传前于本机移除，但仍应确认发送内容。分享、更新、评论、删除和实时发消息都会写入他人可见的数据。队友的消息会在步骤之间送达代理；服务器说明要求先向用户展示并征得同意再执行，除非开启了自动模式。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Session Relay，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

session-relay

Share coding-agent sessions with your team across Claude Code, Codex, OpenCode, Gemini CLI, Copilot CLI, Cursor and ZCode. Run /share in one agent; a teammate runs /pickup in whichever agent they use and carries on with the goal, decisions, next steps and recent conversation.

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

Then, in your agent:

/share/share for bob/pickup/pickup alice's webhook retry work/live                      # working at the same time: see who's on what, message their session

You need a Session Relay server for your team; see self-hosting. Cloud hosting is coming soon.

Commands

relay sessionsYour local agent sessions for this repo
relay share [--dry-run]Pick a session, choose what to include and who sees it
relay share --no-promptsLeave your typed prompts out (relay config prompts hide to always do that)
relay share --diffAttach your uncommitted changes; teammates git apply them after relay pull
relay share --for <name>A handoff for a teammate (also --pr <url>; the branch's PR is found automatically)
relay list, relay search "<q>"Shared sessions. --for-me, --file <path>, or file: / branch: in the query
relay show <id>, relay pull <id>Read a session, or write .relay/handoff-<id>.md for your agent
relay edit <id>Change your share: title, summary, next steps, who it's for, PR
relay pr-comment <id>Post the session on its pull request
relay setup --auto-share onSave each Claude Code, Gemini CLI and Copilot CLI session as a private draft when it ends; relay publish <id> shares it
relay live start, relay live statusWork live with teammates: who's on what and which files
relay live send <name|everyone> "<text>"Message a teammate's live session; it reaches their agent between steps (also reply, inbox, watch, auto on|off, stop)
relay setup --live onHooks so live messages and file overlap warnings arrive in Claude Code and Gemini CLI by themselves
relay templateThe handoff template for this repo
relay export <id>, relay export --allDownload a session (Markdown/JSON) or many (NDJSON)
relay setup --tools geminiConnect one agent you installed later
relay digest, relay statsWhat the team did lately; team stats
relay comment <id> "<text>"Leave a note on a session (the next agent reads it)
relay delete <id>Delete your share
relay members, relay invite --linkYour team; invite links (admins)
relay setupConnect every agent you have installed
relay mcpThe MCP server your agents start

Full reference: CLI docs.

Privacy

Nothing is uploaded unless you share it. API keys, tokens, passwords and private keys are removed on your machine before upload, and relay share --dry-run shows exactly what would be sent. See security & privacy.

License

AGPL-3.0-only

来源：packages/cli/README.md，提交 e83599c

工具

15

list_sessions

List shared sessions

List sessions teammates have shared. Defaults to the current repo; pass all_repos to see everything. for_me lists handoffs assigned to you (from any repo).

输入参数filetoollimitauthorbranchfor_meall_repos

search_sessions

Search shared sessions

Full-text search over shared sessions (titles, summaries, messages). The query can include "file:<path>" and "branch:<name>" filters.

输入参数query必填authorthis_repo_only

get_session

Load a shared session

Load a shared session as a handoff: summary, decisions, next steps, files and conversation. mode "tail" (default) = summary + recent messages; "summary" = summary only; "full" = full transcript, paged with offset.

输入参数id必填modetailoffset

share_current_session

Share this session

Share the session you are in right now with the team. Write the summary yourself from the conversation: it is what teammates read first. Never include secrets.

输入参数fordonegoal必填nexttitlepeoplepr_urlincludesectionscontinuesdecisionshide_prompts另有 3 个

get_session_diff

Get a session's code changes

The uncommitted changes a teammate attached to a shared session, as a unified diff. Use it to see exact code state; to apply it, write it to a file and run `git apply`.

输入参数id必填max_chars

share_template

Get the repo's handoff template

The handoff template for the current repo: extra sections (some required) and instructions to follow when sharing. Call it before share_current_session.

无需输入参数。

team_activity

Team activity

What the team did recently: new shares by repo, handoffs for you, who picked up what, and new comments.

输入参数days

comment_on_session

Comment on a session

Leave a short note on a shared session for the team: a question, a finding, or that you picked it up. Never include secrets.

输入参数id必填body必填

update_session

Edit a shared session

Change a share you made (or any share, if you're an admin): title, summary fields, who it's for, the PR link or visibility. Summary lists you pass replace the old ones; use add_next to append next steps.

输入参数id必填fordonegoalnexttitlepeoplepr_urlpublishadd_nextsectionsdecisions另有 1 个

start_live

Go live

Start working live in this repo: teammates see what you're working on and which files you touch, and their messages reach you between steps. Lists who else is live here.

输入参数titleautonomy

live_status

Who's working live

Who is working live right now: repo, branch, what they're doing, files they touched recently, and whether this session is live.

无需输入参数。

send_live_message

Message a teammate's live session

Send a short message to a teammate who is working live: it reaches their agent between steps. Use it to tell them about a change that affects them, ask a question, or answer theirs. Never include secrets.

输入参数tokindmessage必填reply_towait_seconds

check_live_inbox

Check live messages

Take new messages from teammates sent to this live session (they are marked as read).

无需输入参数。

update_live

Update your live session

Change what teammates see about this live session (title, current status), or whether this agent may act on their messages without asking.

输入参数titlestatusautonomy

stop_live

Stop working live

End this session's live session: teammates stop seeing it and messages stop arriving.

无需输入参数。

版本历史

3
  1. v0.7.0最新Oct 25, 2026
  2. v0.6.0Oct 25, 2026
  3. v0.5.1Oct 25, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分