Session Relay

io.github.RyrahulPublished by GitHub account Ryrahulv0.7.0Updated Oct 26, 2026

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

VerifiedSTDIODesktop onlyDeveloper ToolsCommunication & Collaboration

Overview

AI-generated overview

Shares coding-agent sessions with teammates so an assistant can hand off work, pick up someone else's session, and coordinate live.

What you can do
  • List and search shared sessions, including handoffs assigned to you and filters by file or branch
  • Load a shared session as a handoff with summary, decisions, next steps and conversation at several detail levels
  • Share the current session, following the repo's handoff template, and update or comment on existing shares
  • Read the uncommitted diff a teammate attached to a session
  • See recent team activity and who is working live, with the files they touch
  • Start, message, check the inbox of, update and stop live sessions
When to use it
Useful for teams where several people or agents work on the same repositories and need to pass work between Claude Code, Codex, Gemini CLI, Copilot CLI, Cursor or similar agents, or to coordinate while working in parallel.
Requirements
Runs as a local npm package (session-relay) over stdio, installed globally and set up with the relay CLI. Needs a team Session Relay server, given by the RELAY_SERVER environment variable or saved through relay login, and a personal access token in RELAY_TOKEN unless you logged in. Desktop only.
Before you install
Shared sessions, comments and live messages are uploaded to your team's server, so anything included is visible to teammates; the tooling asks you not to include secrets, and the README says credentials are stripped locally before upload, but review what is sent. Sharing, updating, commenting, deleting and live messaging all write data others can see. Messages from teammates reach the agent between steps; the server's instructions say to show them to the user and ask before acting unless auto…

Installation

In SourceWeft

  1. Open Session Relay in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/cli/README.md at commit e83599c

Tools

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).

Parametersfiletoollimitauthorbranchfor_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.

Parametersqueryrequiredauthorthis_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.

Parametersidrequiredmodetailoffset

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.

Parametersfordonegoalrequirednexttitlepeoplepr_urlincludesectionscontinuesdecisionshide_prompts+3 more

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`.

Parametersidrequiredmax_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.

Takes no parameters.

team_activity

Team activity

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

Parametersdays

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.

Parametersidrequiredbodyrequired

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.

Parametersidrequiredfordonegoalnexttitlepeoplepr_urlpublishadd_nextsectionsdecisions+1 more

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.

Parameterstitleautonomy

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.

Takes no parameters.

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.

Parameterstokindmessagerequiredreply_towait_seconds

check_live_inbox

Check live messages

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

Takes no parameters.

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.

Parameterstitlestatusautonomy

stop_live

Stop working live

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

Takes no parameters.

Version history

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

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts