// ZGO — ENGINEERING REPORT

zgo · Tauri v2 launcher · Alfred port · pure-Rust zgo-core engine

Docs GitHub
// Color scheme

>_ENGINEERING REPORT

zgo is a from-scratch Alfred-class launcher in Rust — a Tauri v2 desktop app over the embeddable pure-Rust zgo-core engine. This report summarizes the architecture and the engine split.

Architecture

Two-part split

The zgo Tauri v2 app (HUD front end, global hotkey, window) over the zgo-core engine (workflows, matcher, feedback, expansion, clipboard, snippets).

Embeddable core

zgo-core builds rlib + staticlib + cdylib, so the launcher engine mounts into the other MenkeTechnologies GUI apps over a C ABI.

Workflow model

Objects + connections, with Script Filter feedback in both JSON and the legacy XML form for compatibility with existing workflow definitions.

Launch surface

Fuzzy matching, variable / token expansion, web searches, clipboard history, and snippet auto-expansion.

Inline tool surface

Keyword-dispatched developer / productivity tools — generators, hashes and HMAC, codecs, colour and WCAG contrast, bases, units, IP/CIDR, cron, date math, world clock, Unicode, URL/JWT parsing, QR payloads, regex, diff, text stats and data conversion — each mapped one-to-one onto a zgo-core command, so nothing lives only in the host.

Smart query router

A keyword-free result row driven by query.classify: the engine ranks a raw query into typed interpretations (calc, unit, colour, base, timestamp, URL, IP, UUID) and names the command that resolves each.

Matcher introspection

Four Preferences panes that analyse zgo's own ranking function through the live matcher: match.minquery (shortest pinning query), match.stability (typo-robustness radius), match.trajectory (per-keystroke Enter safety) and match.regress (catalog drift against a catalog.snapshot baseline).

Native host surface

Global hotkey, tray menu and a native menu bar with accelerators; system actions sourced from the engine catalogue; a pasteboard daemon feeding clipboard history; and paste-to-front-app keystroke injection.

Shared components

The PTY-backed embedded terminal, the multi-pane file browser and the stryke Monaco hooks editor are vendored from the shared MenkeTechnologies component repos, so every app in the stack ships the same ones.

Links