Appicon resolution architecture

Appicon resolution architecture An architecture diagram generated by Archify. Consumers · Waybar, Rofi, scripts, agents · Architecture component Consumers Waybar, Rofi, scripts, agents CLI and MCP · cmd/appicon · internal/appmcp · Architecture component CLI and MCP cmd/appicon · internal/appmcp Resolve daemon · JSON frames over Unix socket · Architecture component Resolve daemon JSON frames over Unix socket User configuration · sources, overrides, packs · Architecture component User configuration sources, overrides, packs Ordered resolver · internal/resolve · Architecture component · first valid local path Ordered resolver internal/resolve first valid local path Local sources · files, XDG, packs, glyphs · Architecture component Local sources files, XDG, packs, glyphs Remote sources · SVGL and opt-in providers · Architecture component Remote sources SVGL and opt-in providers Cache and rasterizer · downloaded SVG · local PNG · Architecture component Cache and rasterizer downloaded SVG · local PNG commands or stdio MCP optional socket request Resolve(options, query) resolve or batch ordered stages and remaps manage config probe in order fetch when enabled rasterize if needed validate and store local path Legend Frontend Backend Database Cloud Message bus External

One resolver

  • • CLI, MCP, and daemon calls converge on internal/resolve
  • • The configured stage order determines precedence

Local result contract

  • • Successful responses return a filesystem path
  • • Remote assets enter the cache before consumers receive them

Network boundary

  • • XDG and packs work offline
  • • Remote providers are allowlisted and most are opt-in