Session Relay

Local

relay.rahulweb.onlineDeveloper Tools5Updated 2d ago

About Session Relay

Session Relay helps teams hand off coding-agent sessions across tools such as Claude Code, Codex, and OpenCode, carrying goals, decisions, next steps, and recent conversation. It combines a CLI, agent commands, and a team-hosted server.

Key features

01Share sessions across coding agents
02Hand off and resume work by teammate
03Search, view, and comment on shares
04Attach uncommitted changes or PRs
05Redact and preview uploads locally

Use cases

01Hand a task to a teammate using another agent
02Resume a teammate’s work with its context
03Share a session and changes on a PR
04Check shared content for sensitive data

MCP support

relay setup connects the MCP server and /share and /pickup commands to installed agents. Agents start the server with relay mcp.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commandnpx -y session-relay

Environment variables to set

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

RELAY_TOKENSecretPersonal access token (srk_...) from Settings → Tokens. Optional if you ran relay login.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmsession-relay0.7.0stdio

Tools

Saved tool list · updated 3d ago

Parameter	Type	Required	Description
file	string	No	Only sessions that touched this file (part of the path is fine)
tool	enum	No	Only sessions from this coding agentclaude-code \| codex \| opencode \| zcode \| gemini \| copilot \| cursor
limit	integer	No	How many to return, newest first (default 10)
author	string	No	Name, email or "me"
branch	string	No	Only sessions shared from this git branch
for_me	boolean	No	Only handoffs assigned to you
all_repos	boolean	No	List sessions from every repo, not just the current one

Details

From the project 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.

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

Then, in your agent:

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

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

Commands


`relay sessions`	Your local agent sessions for this repo
`relay share [--dry-run]`	Pick a session, choose what to include and who sees it
`relay share --diff`	Attach 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 on`	Save each Claude Code, Gemini CLI and Copilot CLI session as a private draft when it ends; `relay publish <id>` shares it
`relay template`	The handoff template for this repo
`relay export <id>`, `relay export --all`	Download a session (Markdown/JSON) or many (NDJSON)
`relay setup --tools gemini`	Connect one agent you installed later
`relay digest`, `relay stats`	What 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 --link`	Your team; invite links (admins)
`relay setup`	Connect every agent you have installed
`relay mcp`	The 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.