Agents

Session Relay works with Claude Code, OpenCode and Codex. Each one gets the same two things:

1. The relay MCP server (relay mcp), which gives the agent four tools:

   Tool	What it does
   list_sessions	Shared sessions for the current repo (or all repos), newest first
   search_sessions	Full-text search over titles, summaries and conversations
   get_session	A session as a handoff: goal, decisions, done, next steps, open questions, files, conversation. mode: tail (default), summary, or full (paged)
   share_current_session	Shares the session the agent is in, with a summary the agent writes

2. Two commands:

   • /share [instructions]: write a handoff and share this session.
   • /pickup <what or whose>: find a shared session, read it, check the code and continue.

relay setup installs both for every agent it finds. Restart your agents afterwards.

relay setup                         # all installed agents, for your user
relay setup --tools claude,opencode # only some
relay setup --scope project         # write config into the current repo instead

#How sessions are read

Tool calls become one line each, so any agent can read them:

• edited src/webhooks.ts
• ran `npm test` → 15 passed
• patched a.ts, b.ts
• wrote config.json (failed: permission denied)

Files only count as "touched" when the write succeeded.

#Manual setup

If you'd rather edit config yourself, the MCP server is just a command: relay mcp. If relay isn't on your PATH, use npx -y session-relay mcp.

Claude Code

claude mcp add --scope user relay -- relay mcp

or, per project, in .mcp.json:

{ "mcpServers": { "relay": { "command": "relay", "args": ["mcp"] } } }

Commands go in ~/.claude/commands/share.md and pickup.md, or .claude/commands/ in a repo.

OpenCode: ~/.config/opencode/opencode.json or opencode.json in a repo:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": { "relay": { "type": "local", "command": ["relay", "mcp"], "enabled": true } }
}

Commands go in ~/.config/opencode/commands/ or .opencode/commands/.

Codex: ~/.codex/config.toml:

[mcp_servers.relay]
command = "relay"
args = ["mcp"]

Prompts go in ~/.codex/prompts/share.md and pickup.md.

The command files relay setup writes are in packages/cli/src/commands/setup.ts (SHARE_PROMPT, PICKUP_PROMPT). Copy them if you set things up by hand.

#Using a different account per project

The MCP server reads the same login as the CLI. To use another account or server for one project, point it at another config file:

RELAY_CONFIG=~/.config/session-relay/client-x.json relay login --server https://relay.client-x.com --token srk_...
relay setup --scope project --relay-config ~/.config/session-relay/client-x.json

#Without MCP

Any agent can use a handoff file:

relay pull rs_7KQ2M9XA     # writes .relay/handoff-rs_7KQ2M9XA.md

Then tell the agent: "Read .relay/handoff-rs_7KQ2M9XA.md and continue from where it stopped." The .relay/ folder ignores itself in git.

#Status

Edit this page on GitHub