runelayChangelog · latest v0.6.6
Changelog
Every release of Runelay, an open source MCP gateway. Installers and binaries are on GitHub releases.
v0.6.6
Memory and skills
- The Memories page has a graph view, like Obsidian's: each memory is a node and every
[[slug]]link is an edge, so clusters and orphan memories show at a glance. It is built from the newGET /v1/memories/graphendpoint.
v0.6.5
Memory and skills
- Agents without a global rules file, such as Cursor, now save a memory with
write_memoryas soon as the user asks them to remember something, instead of only acknowledging it. The MCP tool descriptions and server instructions tell every agent to do this.
v0.6.4
CLI
runelay setupconnects every agent on the machine in one command: it logs in, registers the runelay MCP, writes the global instructions and imports native memory.runelay doctorchecks each agent's setup and says what to fix.runelay homeopens an interactive menu, andrunelay sponsorshows how to support the project.- Every agent gets its own API key, so access can be seen and revoked per agent. Servers older than this release fall back to the shared key.
- For every agent, setup turns off native memory, installs the global instructions and approves only runelay's tools. Imported native memory files are archived.
Memory and skills
- Agents write skills with
write_skill, import many memories at once withimport_memory, andwrite_memorypoints out similar memories so duplicates get updated instead of created.
Connections
- OAuth goes through a relay that publishes a client ID metadata document (CIMD), so servers that only accept CIMD, such as Vercel, now connect.
- Asana, HubSpot and Box are no longer in the catalog.
Panel
- Setup is now a per-agent onboarding: a checklist, desktop or manual setup, a success screen, and the MCP endpoint ready to copy.
Desktop app
- The desktop app bundles the CLI and syncs skills locally, so connecting agents needs no terminal.
- On macOS the menu bar icon is the runelay mark on its own, the same size as the other icons there and readable on light and dark bars. It used to be the whole app icon shrunk to 18 points, which left the mark tiny.
Site and docs
- The site's setup pages and CLI previews show the new onboarding, and the agent and integration guides are updated. runelay.com/cli serves the installer from the latest release.
v0.6.3
Catalog
- Doop (OAuth) is in the catalog: a design canvas where agents build screens as real HTML and CSS and you review and approve them.
Desktop app
- The desktop app tells you when a new version is out, also when it is pointed at a remote server. It checks on open and every six hours, downloads the installer for your system into Downloads and opens it. "Buscar atualizações…" in the app and tray menus checks on demand, and a version can be skipped.
- "Open when the computer starts" also works when the app is pointed at a remote server. With it on, the app opens hidden in the tray and closing the window keeps it there; with it off, nothing changes for remote servers.
Panel
- Connections that use your own OAuth client can list the scopes to ask for, one per line, instead of every scope the server advertises. For Gmail that means you can leave out full mailbox access and delete. Changing the scopes asks you to log in again.
v0.6.2
Desktop app
- The desktop app can open when the computer starts (hidden, straight to the tray) and keeps running in the tray when the window is closed, so agents always reach the local MCP endpoint. Toggle it in the first setup step or in Settings > Server.
v0.6.1
Catalog
- Conty (OAuth) is the featured connector, highlighted at the top of the catalog: agents run creator campaigns from the brief to the sales report.
- Firecrawl (API key) is in the catalog: web search, scraping and site crawling for every agent.
Connections
- Google Calendar, Docs, Sheets and Slides now use Google's REST APIs with runelay's own tools. Google's MCP servers for those services require enrollment in the Google Workspace Developer Preview Program.
- Google Calendar:
calendar_list_calendars,calendar_list_events,calendar_create_eventandcalendar_delete_event. - Google Docs:
docs_read_documentanddocs_append_text, next todocs_create_document. - Google Sheets:
sheets_get_values,sheets_update_valuesandsheets_append_rows, next tosheets_create_spreadsheet. - Google Slides:
slides_read_presentationandslides_add_slide, next toslides_create_presentation. - The first sign-in of each Google connector asks only for that service's scopes.
Fixes
- The panel no longer crashes on unknown Google services.
v0.6.0
Connections
- Google is one connector per service, each a one-click login through the hosted OAuth broker (
auth.runelay.com) that asks only for its own scopes plusopenid,emailandprofile. - Google Calendar (
calendar,calendar.events): list calendars and events, create, update and delete events, suggest times. - Gmail (
gmail.send): send an email with to, subject, body and cc. It can't read mail. - Google Drive (
drive.file): create a text file and list the files runelay created. - Google Docs (
documents,drive.file): create a doc, read and edit docs. - Google Sheets (
spreadsheets,drive.file): create a spreadsheet with rows, read and edit values. - Google Slides (
presentations,drive.file): create a deck with slides of text, read and edit decks. - Google Forms (
forms.body,drive.file): create a form and add text, paragraph, choice and scale questions. - Google Meet (
meetings.space.created): create a meeting space and return its link. - Agents call them as
<connection>.<service>_<tool>(for examplegmail.gmail_send_email), plusaccount_whoamion each. Restricted scopes, such as reading Gmail or full Drive access, are not requested. - GitHub signs in with one click through the broker (scopes
repoandread:user). Its tokens expire and are refreshed automatically. Pasting a token still works.
Panel
- Remote MCP connections can use your own OAuth client: paste a Client ID and, if the service gives one, a Client secret when adding or editing a connection. This is the way in for services without automatic client registration, such as Google. The secret is stored encrypted and never sent back to the panel.
Broker
- The broker supports GitHub at
/github/callbackand/github/token. auth.runelay.com/redirects to runelay.com.- Self-hosters running their own broker set
RUNELAY_GITHUB_CLIENT_IDnext toRUNELAY_OAUTH_BROKER_URLandRUNELAY_GOOGLE_CLIENT_ID.
Fixes
- runelay's Google client ID is the default. v0.5.0 shipped a placeholder, so Google login failed unless
RUNELAY_GOOGLE_CLIENT_IDwas set. - Google Calendar no longer asks for
calendar.calendarlist.readonly.
v0.5.0
Connections
- Google Calendar, Google Docs and Google Sheets are in the catalog. They sign in with one click through runelay's hosted OAuth broker, with no Google Cloud project to set up. Each asks only for the scopes it needs, and the connection keeps a refresh token so it doesn't drop after an hour.
- OAuth broker (
apps/oauth-broker, served atauth.runelay.com): a stateless Cloudflare Worker that holds runelay's registered OAuth apps for providers without dynamic client registration. It relays the login back to your instance and adds the client secret to token requests; it stores and logs nothing. Logins going to a remote instance show a confirmation page naming the destination, PKCE is required, only known parameters are forwarded, and requests are rate limited per IP. Run your own withRUNELAY_OAUTH_BROKER_URLandRUNELAY_GOOGLE_CLIENT_ID.
Site
- Privacy Policy and Terms pages at
/privacy/and/terms/, in English and Portuguese.
v0.4.3
Panel
- Settings: new Organization page to rename the organization, set its image and delete it. Deleting removes its connections, API keys, memories and skills, and is refused while it is your only organization or a member has no other one.
- Connections can be renamed from their detail page. The login, the config and the call history move to the new name; agents see the tools under the new prefix.
Catalog
- Cloudflare (full account API, next to Cloudflare Docs) and Buffer (API key) are in the catalog.
Docs
- Every docs page has its own share image.
v0.4.2
Panel
- Adding a remote MCP now detects how it signs in. OAuth servers (Figma, Linear, GitHub Copilot) say the login opens on save and hide the Headers field; servers that need a key say so.
- "☕ Support the project" in the profile menu and on the setup celebration, opening GitHub Sponsors.
API
POST /v1/sources/detect-auth: classifies a remote MCP asoauth,header,noneorunknownfrom itsWWW-Authenticatechallenge or OAuth protected resource metadata.- Imported OAuth accounts accept a
clientSecretandscopeup to 20,000 characters, sorunelay migrateno longer fails with "Too big: expected string to have <=2000 characters". - CLI login codes are drawn with
crypto.randomInt.
CLI
runelay openopens the dashboard in the browser.
Install
- When Docker has no free address pools, the installer explains how to recover (
docker network prune -f) instead of stopping with the raw error.
Docs
- New docs site at docs.runelay.com: quickstart, self-hosting, CLI, integrations, migrate guides, troubleshooting, FAQ and more.
v0.4.1
- Dashboard lists (top connectors, most used tools, recent skills and memories) stop growing and scroll inside their card.
- The collapsed side panel no longer shows a sliver of its content next to the rail.
v0.4.0
Panel
- New Activity page: every call your agents made through runelay, live. Stats for the last 7 days, filters by agent, connector and status, search, and a timeline grouped by day with each agent's logo, the connector, the tool, duration and time.
- Sidebar sections collapse like an accordion and remember their state.
- No more elastic overscroll on the page.
- Removed the "Soon" placeholders for Tools and organization Settings.
API
GET /v1/activity/calls: paginated tool calls with filters by agent key, connector, status and search, all on the server.
v0.3.5
runelay pullfetches skills in batches of 50 through a newPOST /v1/skills/export, instead of one request per skill and per file. Pulling many new skills no longer hits the per-key rate limit and blocks the agents that share the key.
v0.3.4
- Running
runelay migrateagain no longer touches connections that already work. Before, a second import could replace fresh tokens with stale ones from an agent, or reset a token header added in the panel, and the connection asked for login again.
v0.3.3
- The Docker image is about 4x smaller: a two-stage build ships one compiled server binary, the panel and a minimal Debian, with no Node or
node_modules. Download drops from about 278 MB to about 66 MB, and idle RAM from about 86 MiB to about 52 MiB in our test. - The image no longer includes Node, so local MCP servers launched with
npxneed the desktop app or a custom image. - Site:
/benchmarkpage comparing runelay and Executor, and a Benchmark link in the navigation.
v0.3.2
Desktop app
- First open asks where runelay runs: on this computer or on a server you already have. Pick a card, press Continue, and a short confirmation plays before the panel opens.
- Keep several servers and switch between them from Settings or the Server menu. Adding a server checks that the URL answers as runelay first.
- If a remote server is down, the app offers to retry or go back to this computer.
Settings
- New Settings area with its own navigation: Server, Profile, Preferences and About.
- Server shows the address, status, version and the MCP endpoint for agents.
- Change your name inline and upload or remove a profile photo.
- Sounds, theme and language live in Preferences.
- About links to the GitHub repository and, in the browser, to the desktop download.
Language
- The whole panel is available in Portuguese and English, with dates and numbers following the chosen language.
- Switching language or theme plays a short page transition.
Panel
- Removing a memory, API key or connection asks for confirmation in a popover next to the button. Signing out asks too.
- An empty overview shows a blurred preview of the charts instead of a bare message.
- Charts use the runelay colors.
v0.3.1
Overview
- Calls to memories, skills, context search, tool search and the connection list now count as activity, so the overview no longer stays on "Nenhuma chamada ainda" for agents that mostly read context.
- New charts: daily activity split into connectors and context, usage by type, top connectors with their logos, recent skills and recent memories, and a 30-day error strip.
- One tooltip per chart that follows the hovered bar or segment.
- KPI numbers roll into place when the page opens.
v0.3.0
Desktop app
- runelay as a desktop app for Mac (Apple silicon and Intel), Windows and Linux (AppImage, x64 and arm64). It runs the whole server on
127.0.0.1:4312, no Docker needed, and opens the first-account screen on its own. - The secret lives in the system keychain (Keychain, DPAPI or the Linux keyring) when one is available. Links to other sites open in the browser.
- Local MCP servers by command are on in the app, since it runs on your own machine.
- In the app, the update button opens the download page instead of the Docker command.
Server
- The server compiles to a single binary with the QuickJS sandbox embedded, so
executeworks outside Docker too.
Site
bot.runelay.com/downloadlists every platform with its download buttons and the latest version.
v0.2.2
- A small gap between the rail and the page when the side panel is collapsed.
- New releases show up in the panel within 10 minutes instead of an hour.
v0.2.1
- Connectors that sign in with a token (GitHub) ask for it in a dialog, on install and on the installed card, instead of opening a browser login that cannot work.
- After a browser login, the login tab tells the panel it is done and closes itself, and the panel refreshes on its own.
- A repeated OAuth callback no longer wipes the tokens of a connection that just connected, and no longer shows a stale "login failed" next to a green connection.
- A provider that only lets approved apps sign in now gets a clear message instead of a raw 403. Figma and Intercom left the catalog for that reason.
- The catalog refreshes connection status after an install.
v0.2.0
Panel
- Update button in the rail when a new release is out, with the release notes and a confirmation before updating. The page reloads by itself on the new version.
- Current version shown in the account menu.
- Hide the names of memories and skills with one click, with an animated mask.
Server
- One-click update for owners and admins through an optional
updaterservice (Watchtower) incompose.yaml. The installer generatesRUNELAY_UPDATER_TOKEN. GET /v1/system/versionreports the current and latest release, checked against GitHub at most once an hour.
v0.1.2
- The project lives at
github.com/Andsu-dev/runelayagain, and the Docker image is back at the publicghcr.io/andsu-dev/runelay. - The
executesandbox releases its host handles when setup fails before the code runs. - CI with tests on every pull request, Dependabot and community health files.
- Includes everything from v0.1.1: first-access setup screen and the guided setup as the first screen after signing in.
v0.1.1
- First access: a fresh server opens a "Configurar este runelay" screen that asks for the setup token (or the whole link) instead of a plain sign-in.
- After signing in, the guided setup is the first screen until it is complete.
- Docker image and links now live under the
runelayGitHub organization:ghcr.io/andsu-dev/runelay. - Short install URLs:
curl -fsSL bot.runelay.com/install | shandcurl -fsSL bot.runelay.com/cli | sh.
v0.1.0
First public version of runelay: one MCP endpoint for every account, skill and memory your agents use. Open source and self-hosted.
Install
# server, on any machine with Docker
curl -fsSL https://github.com/Andsu-dev/runelay/releases/latest/download/install.sh | sh
# CLI, on your computer
curl -fsSL https://github.com/Andsu-dev/runelay/releases/latest/download/install-cli.sh | sh
runelay migrateGateway
- MCP endpoint at
/v1/mcpwith nine tools:list_connections,search_tools,call_tool,execute,search_context,read_memory,write_memory,read_skill,read_skill_file. executechains tools in JavaScript inside a QuickJS WebAssembly sandbox: fresh per run, no filesystem, network, process or timers, 32 MB of memory and CPU and wall-clock limits.- Connections: remote MCP with OAuth (dynamic client registration and PKCE), local MCP by command, and OpenAPI specs turned into tools.
- Catalog with ~25 curated MCP servers (Linear, GitHub, Notion, Figma, Vercel, Supabase, Sentry, Stripe and more), installed in one click.
Context
- Skills (
SKILL.mdwith files) and memory ([[linked]]notes) per organization, with full-text search, versions, backlinks and a health report (stale, broken links, isolated). - Context routing: a short brief (pinned rules and an index) synced into
CLAUDE.mdandAGENTS.md, the rest fetched on demand through MCP. Agents write new facts back withwrite_memory.
CLI
runelay loginfinds your server (~/runelay/.envorlocalhost:4312) or asks for the URL, then authorizes in the browser with a code. No keys to paste.runelay migratebrings MCP servers, memories, skills and instructions from Claude Code, Codex, Cursor, Grok, Gemini and OpenCode in one command. Accounts already logged in on the machine (Grok, Codex and Claude Code credentials) arrive connected; the rest go to a reconnect queue in the panel.status,push,pull(brief plus skills materialized into each agent's folder),sync,connect(registers runelay in every client),importandlogout.- Single binaries for macOS (arm64, x64) and Linux (x64, arm64).
Panel
- Organizations with their own connections, skills, memory and API keys.
- Overview with call metrics, connectors catalog and installed list, skills, memory, API keys with a per-key activity timeline, guided setup with a progress timeline, and a reconnect queue that walks through every pending login.
- Monochrome interface with light and dark themes, motion and optional 8-bit sound feedback.
Security
- First account requires a one-time setup token (printed by the installer and in the server log); signups close afterwards.
- Connection configs, OAuth tokens and recoverable API keys encrypted with AES-256-GCM.
- Agents never see credentials: API key requests and
list_connectionsget headers and env values hidden. - Agents cannot pin memories, so a prompt-injected agent cannot plant instructions for every other agent.
- Local commands are off by default (
RUNELAY_ENABLE_STDIO) and, when on, only owners and admins can create them, with a minimal environment. - Private, loopback, link-local and tailnet addresses blocked on every outgoing request and redirect (SSRF and DNS rebinding).
- Rate limit per API key and an audit log of every request a key makes.
- Docker image runs as an unprivileged user with read-only application code.
Distribution
- Docker image
ghcr.io/andsu-dev/runelayforlinux/amd64andlinux/arm64. install.shfor the server andinstall-cli.shfor the CLI attached to every release.
Try it on your machineFree and open source. Runs on your computer or your server.
Download runelayInstall on your server