runelayDocs · CLI
runelay migrate
One command moves what your agents already have into Runelay, an open source MCP gateway: MCP servers, memories, skills and global instructions.
Run it
Run it on the computer where your agents live, because that is where they keep their files. It logs in through the browser if needed, shows a summary per agent, asks once and sends everything to your server.
$curl -fsSL runelay.com/cli | sh$runelay migrateWhat happens to each MCP server
| Result | Which ones | |
|---|---|---|
| OAuth accounts with readable tokens | Arrive connected | Grok; Codex and Claude Code on macOS Keychain |
| Servers that use headers | Arrive connected | Any agent |
| Other OAuth accounts | Reconnect queue in the panel | Includes Cursor, which encrypts tokens |
| Local command servers (stdio) | Stay on the agent | Add them from the panel if needed |
Options and related commands
| What it does | |
|---|---|
runelay migrate --yes | Skips the question. Required without a terminal. |
runelay migrate --replace | Removes the migrated MCPs from the agents and leaves only Runelay. |
runelay import | Only turns MCP servers from agent configs into connections. |
runelay push | Sends memories, skills and global instructions. |
runelay pull | Writes the shared brief and new skills back to the agents. |
runelay connect | Registers Runelay in Claude Code, Codex, Cursor and Grok. |
Worth knowing
- Tokens are sent only to your server and stored encrypted.
- Many providers rotate the refresh token on use. After Runelay refreshes it, the old agent entry may ask for login again;
--replaceavoids that. - Since 0.3.4, running
runelay migrateagain does not touch connections that already work. runelay pullonly edits the block between the Runelay markers inCLAUDE.mdandAGENTS.md.
Questions
Which agents does migrate read?
Claude Code, Codex, Cursor, Grok, Gemini and OpenCode.
Does it delete anything from my agents?
Not by default. Only --replace removes the MCP servers it migrated.
Can I run it in CI?
Use runelay migrate --yes, with RUNELAY_URL and RUNELAY_API_KEY set to a key created in the panel.
Try it on your machineFree and open source. Runs on your computer or your server.
Download runelayInstall on your server