URL Protocol Reference

Every other key in the query string is parsed into the params object and then ignored. There is no theme, language, settings-tab or file parameter, and adding one will not do anything.

// main.js — the whole deep-link surface
app.on('open-url', async (event, url) => {
  event.preventDefault();
  let target = getTopWindow();
  if (!target) {
    await createWindow();
    target = mainWindow;
  }
  if (!target || target.isDestroyed()) return;

  const parsed = new URL(url);
  const pathname = parsed.pathname.replace(/^\/+/, '');
  const params = Object.fromEntries(parsed.searchParams);

  if (url.startsWith('aartiq-browser://')) {
    target.webContents.send('auth-callback', url);
  } else if (url.startsWith('http://') || url.startsWith('https://')) {
    target.webContents.send('add-new-tab', url);
  } else if (url.startsWith('aartiq://') || url.startsWith('comet://')) {
    const command = parsed.hostname || pathname || params.command || 'index';

    const commandMap = {
      'chat': 'open-ai-chat',
      'search': 'ai:search',
      'navigate': 'navigate-to-url',
      'create-pdf': 'ai:create-pdf',
      'create-doc': 'ai:create-pdf',
      'run-command': 'shell:execute',
      'open-app': 'system:open-app',
      'screenshot': 'system:screenshot',
      'volume': 'system:set-volume',
      'schedule': 'ai:schedule',
      'ask-ai': 'ai:ask-speaking',
      'voice-chat': 'ai:voice-chat',
      'set-model': 'ai:set-model',
      'browse': 'open-quick-browse',
      'ocr': 'trigger-screen-ocr',
      'pdf': 'open-pdf-creator',
      'automation': 'open-automation-panel',
      'settings': 'open-settings',
      'index': 'open-main',
    };

    const siriActions = ['chat', 'search', 'navigate', 'create-pdf', 'create-doc',
      'run-command', 'open-app', 'screenshot', 'volume', 'schedule', 'ask-ai',
      'voice-chat', 'set-model'];
    if (siriActions.includes(command)) {
      executeShortcutAction(command, params);
      if (params.speak === 'true') {
        target.webContents.once('did-finish-load', () => {
          target.webContents.send('ai:request-speak-response', params);
        });
      }
    }

    // Sent unconditionally. Of these nineteen channel names only
    // navigate-to-url has a renderer listener; the rest are discarded.
    target.webContents.send(commandMap[command] || command, params);
  }

  if (target.isMinimized()) target.restore();
  target.focus();
});