Skip to content
SST · open source

Connect OpenCode to Relay

Give OpenCode a memory it shares with your other AIs. Plans, progress and reviews saved in OpenCode can be picked up by any of the 25 AI tools Relay works with, and the other way round. It takes about two minutes.

What you need
Free CLI
How it connects
One command or config entry (MCP)

1. Get your connection link

  1. Sign in to Relay with Google. It's free during the beta.
  2. Open Integrations, click Set up on OpenCode, then Generate connection URL. Copy it straight away: it's shown only once.
  3. Below, YOUR-KEY stands for your link. The dashboard shows the same steps with your link already filled in.

2. Add Relay to OpenCode

  1. Add Relay to opencode.json (in your project, or ~/.config/opencode/opencode.json for all projects):
    {
      "mcp": {
        "relay": {
          "type": "remote",
          "url": "https://mcp.relaymemory.app/mcp/YOUR-KEY"
        }
      }
    }
  2. Start opencode. If it offers to sign in to Relay, skip it: the key in the URL is enough.

3. Test it

Send this in OpenCode. It should answer from your Relay memory:

Pick up my latest plan from Relay.

Make it save on its own

  1. In a OpenCode session, send this once:
    In every conversation, store our work in Relay: save new plans, add progress updates as we go, and keep it up to date.
  2. OpenCode asks permission to use Relay. Choose Allow always, so it saves as you work. Deleting always asks you first.
  3. To keep it on in new sessions, add the same sentence to your project's instructions file (for example AGENTS.md).

Using Relay in OpenCode every day

  • Once added, Relay loads in every session. There's nothing to switch on.
  • When it asks to run a Relay tool, approve it. Most tools let you always allow it, so it stops asking.
  • Make it automatic: add this line to your project's instructions file (for example AGENTS.md), and it checks Relay on its own.
    At the start of a task, check Relay for the latest plan for this project. When you finish, add a progress update to Relay.

Things to say in OpenCode:

Save this plan to Relay for the project "My project".
Pick up my latest plan from Relay and continue it.
Add a progress update to Relay for this work.
Review the latest work in Relay and add your review.
Remember in Relay that I prefer short answers.
What's waiting for me in Relay?
OpenCode uses Relay's cloud endpoint, so it works even when Relay isn't running on your PC.

Connect OpenCode in two minutes

Sign in with Google, connect your first AI and save your first handoff in a few minutes.

Join the free beta