# Session Relay

Session Relay hands off a coding session from one developer to another: goal, decisions, next steps and conversation history. A teammate runs /pickup in their agent and continues.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: Ryrahul
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Ryrahul/session-relay/tree/HEAD/packages/cli
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/session-relay

## What it does

One person runs `/share`, another runs `/pickup` in their agent and gets the context: what was done, what was decided, what comes next. You can hand off to a specific teammate (`/share for bob`), attach uncommitted changes (`--diff`), or link a pull request. The `/live` command shows who is working on what and lets you send a message to a teammate's session — it reaches their agent between steps.

You need to deploy a Session Relay server for your team; the docs cover self-hosting. Cloud hosting is not yet available. Prompts and secrets (API keys, tokens, passwords) are filtered locally before upload; `relay share --dry-run` shows what would be sent. The `relay setup` command connects the MCP server to every installed agent.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `RELAY_SERVER`, `RELAY_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env RELAY_SERVER=<RELAY_SERVER> --env RELAY_TOKEN=<RELAY_TOKEN> --transport stdio cli -- npx -y session-relay
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add cli --env RELAY_SERVER=<RELAY_SERVER> --env RELAY_TOKEN=<RELAY_TOKEN> -- npx -y session-relay
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "session-relay"
            ],
            "env": {
                "RELAY_SERVER": "<RELAY_SERVER>",
                "RELAY_TOKEN": "<RELAY_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "session-relay"
            ],
            "env": {
                "RELAY_SERVER": "<RELAY_SERVER>",
                "RELAY_TOKEN": "<RELAY_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e RELAY_SERVER=<RELAY_SERVER> -e RELAY_TOKEN=<RELAY_TOKEN> cli npx -y session-relay
```
Replace <…> with your own values

## When to use it
- hand off an unfinished task to a teammate with full context
- pick up where another developer left off
- see who on the team is working on what right now
- send a message into a teammate's agent session
- preserve session history for the team

## Example prompts
- Share this session with Alice and attach my uncommitted changes
- Pick up Bob's last session on webhook retries
- Show me who's working now and on which files

## Similar
- [om-share-this-session](https://affpapa.org/en/nevibecode/skills/om-share-this-session.md) — skill · 950 installs
- [Erkle team memory](https://affpapa.org/en/nevibecode/mcp/erkle-team-memory.md) — MCP server · ★ 1 repo stars
- [session-learning-capture](https://affpapa.org/en/nevibecode/commands/session-learning-capture.md) — command · 425 installs
- [relay](https://affpapa.org/en/nevibecode/skills/relay.md) — skill · ★ 880 repo stars
- [azure-fluid-relay](https://affpapa.org/en/nevibecode/skills/azure-fluid-relay.md) — skill · 160 installs
- [solo-to-team-skills](https://affpapa.org/en/nevibecode/plugins/solo-to-team-skills.md) — plugin · ★ 1087 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
