Deep Linking

The Eliza desktop app registers the eliza:// custom URL protocol so that external applications, browsers, and OS-level actions can open and communicate with the running app. Protocol registration is handled by the Electrobun deep linking integration and is set up during app initialization before the main window loads.

When an external application opens a eliza:// URL while the app is already running, Electrobun routes the URL to the native runtime. If the main window is not yet ready (still loading), incoming payloads are queued and flushed to the renderer once the did-finish-load event fires. Events are dispatched to the renderer as eliza:share-target custom DOM events.

Features

• eliza://share URL handler for sharing text, URLs, and files from external apps or browsers
• File drag-and-drop via the desktop runtime open-file OS event (macOS)
• Payload queuing when the renderer is not yet ready
• DOM event dispatch (eliza:share-target) for consumption by the web UI
• Fuzzy parameter parsing — title, text, url, and one or more file path parameters

Configuration

No configuration file is required. The protocol is registered automatically at startup via the Electrobun integration. The URL scheme is eliza:// and cannot be changed without rebuilding the app.

Share URL format:

eliza://share?title=Hello&text=Check+this+out&url=https://example.com
eliza://share?file=/Users/alice/Documents/report.pdf

Listening for share events in the renderer:

document.addEventListener("eliza:share-target", (event: CustomEvent) => {
  const { title, text, url, files } = event.detail;
  // Handle the incoming share payload
  attachToCurrentConversation({ title, text, url, files });
});

Related

• Desktop App — full desktop app architecture and embedded agent runtime
• Native Modules — Canvas module that intercepts eliza:// URLs in auxiliary windows
• Mobile App — equivalent deep link handling on iOS (AppDelegate) and Android (MainActivity)