Skip to content
Vulpine
Esc
↑↓navigate↵open⌘Jpreview
On this page

Vulpine.app design principles

Who Glyph is for, the job it does at the desk, and the product principles its design follows.

Living doc, checked against the code 2026-11-14

Platform

web (a Tauri overlay on macOS)

Users

The operator at a Mac desk, talking to Pi-backed agents while other work stays on screen. Glyph, the look of Vulpine.app, is the always-present overlay, not a document window.

Product Purpose

Glyph is a desktop presence for the voice that never takes focus. It shows listening, thinking and speaking. A tap on the face mutes or unmutes the mic; Operations holds the rest. The face is one the operator wants to leave visible and can dress to taste.

Positioning

A signed macOS overlay that never covers the desk and never owns the mic: capture stays with the Client Core. Its body and face come from a small wardrobe, not one fixed mascot.

What the operator chooses

Glyph is cut into layers (ADR 0036): the operator picks the body and the face, and the theme follows.

  • Body (chassis): where Glyph sits and how it frames the face. Six ship: Halo is the everyday body; Classic (the disc and capsule), Island, Familiar, Ribbon and Printer are offered while the Labs switch is on (LABS_BODIES in src/lookStyle.ts), and a saved pick of one keeps drawing.
  • Face (avatar and variant): what presence looks like. Four families: Orb (the classic experiments and Iris), Cast (Seal, Sigil, Corona, Hyphae, Beat), LED (the bar, Scanner, Hex, Dots, Trace) and SVG (Brass, Line, Scope, Bloom). The second-string variants are offered only with Labs on (LABS_VARIANTS).
  • Face choices: a variant for each family, a pinned mood or auto, the face opacity (20–100 %) and the ring light (a phase-lit rim in the mood color). They apply live, and glyphctl, the Admin and Glyph read the same record.
  • Theme: color, type and materials as data, the only layer that loads at runtime.

vulpine-glyphctl look, chassis, face and subtitles drive every choice from the CLI.

A fresh install opens as Halo body, Cast face, Seal variant ([glyph] chassis = "halo" in a new config.toml). A stored choice wins. Iris, Scanner and Line are the defaults for their families.

Operating Context

  • An Aqua (GUI session) launch of /Applications/Vulpine.app (com.voidfab.vulpine). The bundle identifier is stable, so macOS privacy grants survive rebuilds.
  • The gateway runs on a Mac in the house: the same Mac, or another one that Glyph reaches through the relay.
  • At rest Glyph is the body and the face plus a quiet status line. Operations opens on a mirror of the current face, body and mood, above five groups: Look, Voice, Conversation window, Connection & privacy and App.

Capabilities and Constraints

  • An NSPanel at status level: it joins all Spaces, shows without activating, and is click-through except over the hit areas the chassis reports.
  • The face is the mic toggle. The Client Core is the only capture owner; nothing in src-tauri captures audio.
  • Every face tints with the mood, turns warm gray while the mic is off, holds still under reduced motion, and picks its detail from its drawn size.
  • No hover states: the overlay turns click-through as the pointer leaves, so a hover would stick.
  • Plugins fill named slots (caption, toast, panel, attention, receipts, ask) at three densities (glance, peek, panel). Each body declares the densities it has room for.

The Halo and the Island carry two glances: a level meter (mic and playback level) and the herdr attention glance.

Brand Commitments

  • Name: Vulpine.app (the desktop app), Glyph (its overlay look, never an app name), Vulpine (the system), Fox Nine (the callsign). foxline stays a code identifier until its family migrates.
  • Not Vigil: Vigil is the browser look with its own frames and portraits (ADR 0037); Glyph is the overlay.
  • No HUD card and no generic AI-assistant blob.
  • The brass phonogram (record and tonearm) is one face variant (SVG · Brass).

The app icon is the Vulpine fox tile, the same tile as Vulpine Gateway.app’s: assets/brand/vulpine-app-icon.svg (the Vulpi fox-head mark on the ink squircle).

Product Principles

  1. Presence is an object on the desk, not a panel over it.
  2. The face is the product; a body frames it and never competes with it.
  3. The operator dresses Glyph; defaults are good, choices are first class and apply live.
  4. Click-through and no-activate are product truth, not visual garnish.
  5. Radio discipline: quiet until live, over dashboard density at rest.
  6. Never a second capture owner to make the overlay prettier.

Was this page helpful?