# Remembra Relay

Passes Git state, test results, and unfinished work from one coding session to the next. Useful when a different agent or machine picks up the project.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: remembra-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/remembra-ai/remembra
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/remembra-relay

## What it does

When a session ends, Relay gathers the branch, commits, changed files, and unpushed commits from Git. For Claude Code and Codex, it also reads commands and test runs from the local session transcript. Matching secrets are removed before transmission, and the transcript stays on your machine.

At the next session, the agent receives a short brief covering completed work, failures, and a next step. Browse the handoff history with `remembra-relay trail` or the Trail page in the dashboard. Setup requires a `REMEMBRA_API_KEY` and MCP configuration. Codex runs hooks only after you approve them; a changed hook command needs approval again.

The brief treats recorded details as untrusted data. Facts submitted by an agent through `close_session` are marked as unverified, and Relay does not validate their origin. Keep that distinction in mind when relying on an agent-reported handoff.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `REMEMBRA_API_KEY`, `REMEMBRA_URL`, `REMEMBRA_AGENT_ID` — 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 REMEMBRA_API_KEY=<REMEMBRA_API_KEY> --env REMEMBRA_URL=<REMEMBRA_URL> --env REMEMBRA_AGENT_ID=<REMEMBRA_AGENT_ID> --transport stdio remembra-relay -- uvx remembra-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add remembra-relay --env REMEMBRA_API_KEY=<REMEMBRA_API_KEY> --env REMEMBRA_URL=<REMEMBRA_URL> --env REMEMBRA_AGENT_ID=<REMEMBRA_AGENT_ID> -- uvx remembra-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "remembra-relay": {
            "command": "uvx",
            "args": [
                "remembra-mcp"
            ],
            "env": {
                "REMEMBRA_API_KEY": "<REMEMBRA_API_KEY>",
                "REMEMBRA_URL": "<REMEMBRA_URL>",
                "REMEMBRA_AGENT_ID": "<REMEMBRA_AGENT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "remembra-relay": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "remembra-mcp"
            ],
            "env": {
                "REMEMBRA_API_KEY": "<REMEMBRA_API_KEY>",
                "REMEMBRA_URL": "<REMEMBRA_URL>",
                "REMEMBRA_AGENT_ID": "<REMEMBRA_AGENT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e REMEMBRA_API_KEY=<REMEMBRA_API_KEY> -e REMEMBRA_URL=<REMEMBRA_URL> -e REMEMBRA_AGENT_ID=<REMEMBRA_AGENT_ID> remembra-relay uvx remembra-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from remembra-mcp <command>

## When to use it
- carry Git state into the next agent session
- share test runs from Claude Code or Codex transcripts
- flag changed files and commits that have not been pushed
- review the handoff sequence across sessions

## Example prompts
- Prepare a brief from the previous session with Remembra Relay before continuing the project.
- Close this session and pass the next agent the commit and test facts.
- Show the project handoff history with `remembra-relay trail`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

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