Velja macOS Smart Browser Picker & URL Router AI Skill Guide (Claude)

Overview & Engine Architecture

Velja is a smart browser picker and URL router for macOS engineered in native Swift by Sindre Sorhus. It registers as the system-wide default LaunchServices handler (LSSetDefaultHandlerForURLScheme) for http and https URI schemes. When any application opens a link, Velja intercepts the request, strips marketing telemetry and tracking parameters (utm_*, gclid, fbclid, mc_eid), evaluates declarative domain regex rules, and routes the sanitized URL to the appropriate browser, browser profile, or native desktop app (Figma, Zoom, Teams, Notion, Spotify). Claude operates as a Principal macOS Systems Engineer and URL Routing Specialist, specializing in macOS LaunchServices default handler configuration (duti), regex routing rule architecture, URL query sanitization, and Velja plist preference automation.

Velja Interception & Routing Architecture