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

Components

Every folder under apps/, runtime/, services/, crates/ and tools/, described by its README or its main module's own header.

Generated from the code

apps/

folder what it is
apps/acp-host-gpui Inactive native invocation ownership; no production backend or human-input authority.
apps/admin-popout The TS Admin is gone (2026-11-07). apps/admin was deleted; the GPUI Admin (apps/admin-shadow, Vulpine Gateway.app) compiles this crate’s model.rs in and pops out a window of its own. The rows below that name ts-admin/… are the record of how the TS Admin owned this window;
apps/admin-sessions-popout The TS Admin is gone (2026-11-07). apps/admin was deleted; the GPUI Admin (apps/admin-shadow, Vulpine Gateway.app) compiles this crate’s model.rs in and pops out a window of its own. The rows below that name ts-admin/… are the record of how the TS Admin owned this window;
apps/admin-shadow Vulpine Gateway.app is the gateway’s host app. Its window, the Gateway window (the Admin in the code), draws every Admin section in one GPUI window, from admin_core in process. Its name, bundle id com.voidfab.vulpine.gateway, executable vulpine-gateway and brand icon are all in bundle.json.
apps/convo-freya The desktop conversation window, in freya: each turn with the actions it took, the jobs it started and the panels it showed, replayed from a fixture or observed read only from a live gateway.
apps/convo-gpui The Glyph’s conversation window, drawn in GPUI on the native kit: each turn with its words, its tool chips, its jobs and its panels, observed read only from the gateway. Under ADR 0046 as amended on 2026-10-18 (shell option B) it is the Glyph’s sidecar.
apps/convo-panel The conversation panel shared by the macOS conversation window and the phone app (“share convo panels between iOS and MacOS”).
apps/fox-gpui The operator’s fox in a native window: the clips of a Clawd theme (his vulpi v4) played through GPUI’s image path with motion-core’s stepper, picked from the observed session’s presence by the reducer Vigil runs.;
apps/freya-kit The kit the freya windows share: the slate tokens, the menu-bar tray, the labeled-node rule and card.v1 drawn natively, every block kind as a real chart, table or grid in Vigil’s looks.
apps/glyph Vulpine.app is the desktop app on the Mac (bundle id com.voidfab.vulpine, productName in src-tauri/tauri.conf.json). Glyph is its look: an ambient overlay that sits on screen beside your work. On this page “Glyph” means the app as it draws in that look; menus and logs still say Glyph.
apps/gpui-library The root of the GPUI crates every native window shares: one Cargo workspace with one lockfile, one gpui-fast pin and the [patch.crates-io] table once, over the engine, motion-core and the native kit, with no package of its own (ADR 0066).
apps/gpui-looks The proven shader looks as one library crate: dither, ASCII, CRT, dot matrix, pixel and wide-gamut HDR (the operator’s top-priority styles), with bloom, foil, palettes and LUTs beside them. They apply over a surface3d frame (the post passes) or over any GPUI subtree (the effect).
apps/gpui-scene3d What every model the library draws is posed and framed by, whatever file it came from.
apps/gpui-scene3d-gltf-vrm The first loader crate of the renderers layer (ADR 0066 §1), on the core (apps/gpui-scene3d). A consumer turns it on with its own feature: native-kit’s meshy (the GLB reader and the fixtures) and vrm (this crate’s vrm).
apps/gpui-surface Internal, publish = false, version 0.x. This is a narrow extraction of native-kit’s existing surface host, device, producer, input and output-color contract, not a public release or universal SDK.
apps/motion-core Springs, easing, keyframes and a frame stepper with no toolkit in them, for the GPUI native views of shell option B. The conversation window (apps/convo-gpui), the Admin’s event-timeline pop-out (apps/admin-popout) and the cards (apps/native-cards) depend on it by path.
apps/native-cards card.v1, the panel the brain and its tools fill, drawn in GPUI on the native kit: every block kind, block for block as Vigil’s panel kit draws it, every node labeled by construction.
apps/native-kit The kit every GPUI window builds on: the slate tokens, the labeled-node rule as a type, gpui-kit’s components and the 3D views. It links no vulpine crate: the gateway client and the decision client live at the app edge, apps/native-kit-edge.
apps/native-kit-edge vulpine’s gateway link and decision client for the native kit, moved out of the kit so the GPUI library links no vulpine crate (ADR 0066).
apps/orb-gpui The Glyph’s Classic disc drawn by a small native window instead of a WebGL canvas in the Glyph’s web page. The operator, 2026-10-19 23:34 MDT: “the orb native by default, the WebKit orb kept as a labeled option”.
apps/orb-styles A registry of shader styles for a voice orb, library-shaped for the GPUI library (no vulpine types, MIT, path dependencies only). The ask: orbkit is “one of the first rust gpui ports i want to see”. This is that port.
apps/panel-web The site’s /talk page shows the conversation panel (apps/convo-panel) and the reply cards (apps/native-cards) drawn by GPUI itself, in the reader’s browser.
apps/phone Vulpine on iPhone, in development: a GPUI app over the in-process Rust core (crates/phone_core). It is not yet released; this page says what the current build does. Its display name is Vulpine and its bundle id is com.voidfab.vulpine.phone (Info.plist); device builds sign as com.voidfab.vulpine.phone.dev.
apps/satellite-esphome The bridge (ADR 0033) is one Node process per device. On one side is the ESPHome native API (esphome-client 2.x, Noise-encrypted). On the other is the Vulpine gateway, reached as an ordinary protocol-v5 client that is also an owner.
apps/sidecar-window The TS Admin is gone (2026-11-07). apps/admin was deleted; the GPUI Admin (apps/admin-shadow, Vulpine Gateway.app) compiles the two pop-outs’ models in and pops out a window of its own, so nothing starts these sidecars today; folding them in retires this crate (ADR 0060’s follow-up).
apps/site Vulpine’s public face: one static Astro page beside the docs, a specification sheet in ink, paper and orange. The page has a light and a dark theme from prefers-color-scheme. It uses the system font stack, plus one self-hosted OFL face (Oxanium) for the sheet’s labels, the page’s small caps and its numerals.
apps/tui The terminal frontend: a text-only client of the gateway, as Vulpine.app and the browser are. The Client Core (packages/voice-client) runs the protocol-5 hello, the owner handshake (ADR 0024) and the session. The TUI draws what comes back with pi-tui (@earendil-works/pi-tui 1.4.0, the version Pi 1.4.0 ships).
apps/vigil Vigil — a conversation-first web frontend on the Client Core, with selectable frames, optional portraits and a transcript drawer (ADR 0037). just dev serves it with Vite.
apps/visuals-showcase BW2 of. The ask was “a bit of a showcase of the new capabilities like shaders and webgpu/webgl/threejs implementation, so by showing a few cool novel ideas we can select some new features to build off of them”.

runtime/

folder what it is
runtime/aecprobe The echo-canceller probe and its launchd job: aecprobe captures the mic and a process-tap reference together as 16 kHz mono WAVs, and daf-rs probe (crates/aec_daf) runs it, cancels the pair in process and reports the residual (ERLE, residual, delay) as one JSON receipt.
runtime/agent_link The vulpine connector, vulpine-agent-link (ADR 0057 §2): one remote MCP endpoint every linked frontier agent calls. Claude (a custom connector), ChatGPT, a Grok Bot or a user’s own MCP client links the same way.
runtime/ambient-caption A small audio language model over the last 30 s of room audio. It reads the gateway’s stdio worker protocol fox9-pcm-f32le-v1: the same 16 kHz mono float32 PCM and the same ops (F frame, R reset, Z flush, Q quit) as the SoundAnalysis sidecar (runtime/ambient-sidecar).
runtime/ambient-sidecar Stream a raw f32le mono file through fox9-ambient-sidecar and print its windows.
runtime/audioctl vulpine-audio (audioctl before), the gateway’s output-device adapter: it lists and sets the default output device and its volume and watches for changes, CoreAudio only, no grant. The gateway runs it as [audio_output] audioctl (the key keeps its name;
runtime/calls vulpine-call (was callctl) answers “is the operator in a call?” as one bounded JSON receipt from what the OS already knows: which processes hold the microphone and whether any camera is running. It captures nothing and needs no grant.
runtime/disk_snapshot The laptop’s daily disk growth snapshot and its launchd template: one line per day of where the root volume’s bytes went, read-only.
runtime/dot_worker The operator’s OpenAI Dot as a background worker for fox9. The Dot is the ChatGPT agent that already holds the operator’s connected mail and calendar. fox9 hands it a request (“ask my Dot to summarize my unread mail”) and reads the answer later.
runtime/fleet_probe fleet_probe.py, the probe that runs ON a fleet host: Python 3.9 stdlib, no writes, one JSON object and exit. crates/vulpine_fleet embeds it at build time (include_str!) and runs it as - on the gateway host and ssh … python3 - on the others; it is also the forced command behind the mini’s restricted probe key.
runtime/fm-brain A Swift CLI that serves the gateway’s compact background lane from the macOS 26 on-device model (a prewarmed LanguageModelSession). It speaks the subset of pi’s RPC line protocol the gateway uses (prompt/abort/set_session_name/get_state… in; message_update/tool_execution_/error/agent_end out).
runtime/grants The grant holder and its Brain-tool clients. fox9grants is one signed LSUIElement app bundle whose executable answers CLI subcommands, so the TCC grants it collects (Calendars, Reminders, Messages read, and since Screen Recording and Accessibility for the screen agent) keep a stable identity across gateway…
runtime/health healthctl: Apple Health facts for the voice brain from a read-only SQLite store on the machine. The brain tool pi_health runs it.
runtime/herdr_convo Readers for what a herdr agent said and whether its checks passed. convo.py returns the last thing a Claude, pi or codex agent said, read from its own session file rather than the pane’s screen; checks.py digests the last test or compile output on a pane’s screen into a verdict.
runtime/herdr_dispatch worktree.py makes one worktree per dispatched herdr task, with a preflight. The voice brain names a task and this script, with fixed argv and stdlib only, makes or finds the sibling worktree, records a handoffs ledger row and gives the lane its own build cache as a clone of the primary checkout’s.
runtime/herdr_report verify.py is the deterministic, read-only checker for a Herdr agent’s task report: it compares what the report claims (changed files, staged files, acceptance paths, recorded run evidence) with the real state of the worktree.
runtime/herdr_standup standup.py reports, per worktree of one checkout, what landed, what is published but unmerged and what is still uncommitted, as JSON that can be read aloud. It is stdlib-only and read-only (git with –no-optional-locks, never touching the index) and prints no shas unless asked.
runtime/home_bridge homectl is the reference implementation of the events-in contract (ADR 0034; docs/integrations/README.md, contract v1). It runs on the gateway host as a child of the gateway ([home_bridge] enabled = true).
runtime/k-brain The foreground brain for the baseline-test dialogue eval: the operator is the interrogator, Fox9 is K. Every operator line arrives as a prompt. K’s answer is a lookup on the cue word the line ends on (k-lines.json, generated from docs/evals/baseline-test.toml).
runtime/llama-brain An engine for the compact lane, beside Apple Foundation Models (runtime/fm-brain). It has fm-brain’s process-level contract: pi’s RPC lines in (prompt / abort / set_session_name / get_state / …), message_update text deltas and agent_end out. brain.background_command can point at it unchanged.
runtime/localvqe-worker lvq-worker runs LocalVQE v1.3 (s2s.cpp’s ggml/Metal port) for the gateway’s [wake] lvq_shadow lane. The gateway feeds it the session’s 16 kHz mic, with the TTS it is playing as the far end, and runs a second wake worker on its output. That worker’s wakes are wake_lvq trace rows and never arm anything.
runtime/memory_index The live project-memory index job (launchd com.voidfab.fox9.memory-index): refresh_live_index.sh rebuilds the index from build_corpus.py’s corpus and pushes it to the mini, digest-gated and atomic (VULPINE_INDEX_FORCE=1 bypasses the gate).
runtime/messages wactl: the operator’s unread WhatsApp chats for the voice brain, read-only, over an installed wacli (MIT). The brain tool pi_whatsapp runs it.
runtime/mynah-stt vulpine-mynah-stt-helper, the first-party STT helper for a box with no Apple Neural Engine. It speaks the gateway’s STT worker wire on loopback and transcribes with Nemotron 3.5 streaming through mynah-asr’s C library, linked in. Silero’s VAD runs in the same process and ends each utterance.
runtime/operator_memory operator_memory.py builds operator episodic memory from armed-final receipts (Lane A). It runs on the corpus host (the mini): transcript-derived content never leaves that host, proposals and promoted episodes are owner-only Markdown files, and everything printed is aggregate counts.
runtime/qwen3_tts_worker The Python MLX Qwen3-TTS worker the gateway’s qwen3-worker TTS adapter drives (stdio ABI qwen3-tts-worker/v1). The gateway embeds the file with include_bytes! (crates/voice_gateway/src/ws/adapters.rs) and runs it under uv. It is on runtime-python-exceptions.toml because its engine is MLX (ADR 0041 §2).
runtime/reach vulpine-reach, the mini’s reach helper (ADR 0053 addendum 2026-11-04, A1, A4, A5). It accepts iroh connections from paired client machines and bridges each protocol to the gateway’s loopback endpoints.
runtime/relay The laptop’s relays to the mini: the Glyph’s to the gateway (glyph_gateway_relay.py, laptop loopback :8780 or :8792 to the same mini port), the Admin’s to the mini’s Admin socket (admin_gateway_relay.py), and their launchd jobs.
runtime/remote remotectl turns the Chromecast Voice Remote’s voice key into a hold-to-talk microphone (under the hold-to-talk). The remote speaks Google’s Android TV Voice (ATVV) service over Bluetooth LE. Holding the voice key starts a 16 kHz IMA ADPCM stream (AUDIO_START reason 0x03).
runtime/remote_ptt remote_ptt turns a paired Siri Remote’s Siri button into a hold-to-talk trigger. Hold the button, speak, let go. It reads the remote over IOKit HID and needs only the Input Monitoring grant.
runtime/room_speaker roomctl makes a room say or play something. It is one Rust binary (crates/vulpine_room) with the file name vulpine-room. A roomctl link to it still works and prints one deprecation line on stderr.
runtime/screen The screen agent: a pure-Swift macOS tool (screenctl) that captures one frame of what the operator is looking at as typed, bounded input and OCRs it on-device, plus the insert policy and Python client that write text back through Accessibility.
runtime/session_review The nightly session review: last night’s brain sessions as an issue inventory, counts only.
runtime/sound-detector Fox9-sound-detector — engine 2 of the sound watches: the 54-class sound-event detector (surround-sound) on CoreML, behind the gateway’s stdio worker protocol (docs/design/sound-watches-2026-10-27.md).
runtime/sound-head-trainer Fox9-sound-head-trainer — a custom sound head trained on the operator’s labeled clips.
runtime/speechctl vulpine-speech (was speechctl): Apple’s on-device SpeechAnalyzer as the second-opinion decoder the gateway’s [shadow_stt] second_opinion_command runs, one swiftc file with no packages. status, transcribe (a WAV, or raw PCM on stdin), serve (one resident process on a socket) and ask;
runtime/systemone-ane kev r6 on the Apple Neural Engine, served as a decision.v1 endpoint (POST /v1/systemone) on a loopback port.
runtime/time_machine It answers one question: “what was happening at T ± a window?” It lines up the gateway trace and every coding-agent transcript on one clock, in the ClickHouse that moraine already writes to.
runtime/vigil-serve Vigil’s installed build, served on the mini’s loopback at 127.0.0.1:8794 by the LaunchAgent com.voidfab.vulpine.vigil. just apps::vigil-install ships the build to ~/.local/state/vulpine/vigil; this server makes it a page you can open at any time instead of a one-shot python3 -m http.server.
runtime/vision The camera-vision adapters (ADR 0034 adapter tier): visionctl answers “who is there?” for one camera as a verb with a receipt, and the other files label, aim and probe the cameras. They run outside the gateway; the gateway or the operator invokes them by hand.
runtime/wyoming-kokoro The Wyoming fallback TTS engine: kokoro-onnx with the af_heart voice, served over the Wyoming protocol on 127.0.0.1:10210 by the LaunchAgent com.voidfab.vulpine.wyoming-kokoro.

services/

folder what it is

crates/

folder what it is
crates/acp_boundary vulpine-acp is an inactive workspace library: the deterministic boundary and session executor of ADR 0070. The gateway does not link it, and it makes neither ACP role available or active.
crates/acp_node_gate Private final-image gate; not a qualification receipt or an application FFI API. ![deny(unsafe_op_in_unsafe_fn)]
crates/admin_core The Admin’s UI-free core (docs/design/admin-core-split-2026-10-14.md).
crates/admin_markers The Admin owner-socket rules the gateway and every Admin shell share (ideas). Before this crate they lived in crates/voice_gateway, so admin_core (and any TUI, GPUI or phone shell) linked the whole gateway to read two marker files, resolve one socket path and gate one string.
crates/aec_daf Rust port of LocalVQE’s DAF front-end (ggml/daf_frontend.cpp, LocalAI-io/LocalVQE, Apache-2.0): gated GCC-PHAT bulk-delay prealignment + a partitioned-block frequency-domain Kalman filter (M = 128 samples = 8 ms blocks, N = 128 partitions = 1.024 s tail, NFFT 256, K = 2 data-reuse updates) + the 2,742-parameter “v2xp…
crates/capture_record The capture recorder (CC2, the recording half of “show Vulpine, don’t describe”): a window or a region recorded with the microphone, marks made while recording (⇧-drag ink, ⇧-click pins, ⇧⌥-drag boxes, timed to the stream), and after stop the same capture.v1 bundle a still capture makes (the contract doc is)…
crates/convo_feed Convo_feed: the conversation window’s toolkit-free half, shared by both windows (BS2 of). The frozen freya window (apps/convo-freya) and the GPUI window (apps/convo-gpui, ADR 0046 as amended 2026-10-18) link it by path; it holds no toolkit.
crates/coreml_stt A clean-room Rust runner for Parakeet TDT 0.6B v3 through Apple CoreML. The acoustic encoder runs on the Neural Engine and the transducer decode loop on the CPU. It uses no GPU ops, so STT does not contend with TTS and end-of-utterance detection for the GPU during barge-in.
crates/decidectl Decidectl: fox9’s client for a local typed-decision model on the decision.v1 wire (docs/contracts/decision.v1.md).
crates/evidence_harness Offline corpus replay harness for acoustic evidence experiments.
crates/extension_pack Extension packs, one installable unit for everything a user adds to vulpine (plan slice 17 packs L1; the contract vulpine.extension-pack.v1 in docs/contracts/extension-pack.v1.md, the design docs/design/extension-packs-2026-11-07.md §4).
crates/fleet_probe Vulpine-fleet-probe: runtime/fleet_probe/fleet_probe.py as one static binary per fleet host (ADR 0041). It runs ON a fleet host, prints ONE JSON object (the Python probe’s bytes: fox9-fleet-probe/1) and exits;
crates/glyph_shader_check The Glyph’s WGSL, parsed and validated with naga before it ships.
crates/hc_approve The prompt-hash-bound approval guard for herdr-core (hc) terminals (ADR 0055 §4).
crates/head_mlxc Head_r9 from Rust with no Python.
crates/helper_manifest A runtime helper’s --vulpine-manifest answer (ADR 0063 §6): the tool.v1 manifests of the tools it backs, and the stream format the vulpine CLI reads them back with (vulpine tool adopt, vulpine tool check --helper).
crates/host_footprint Ledger row 621: the Glyph on this host’s memory footprint, read natively — main against WebKit MB and the lifetime max.
crates/mynah_stt_shim The STT worker wire in front of mynah-asr’s streaming WebSocket, protocol v2.
crates/openai_speech_shim A Wyoming TTS server in front of an OpenAI-speech server.
crates/overlay_stdio The gateway roll itself: it swaps or inspects a numbered stdio overlay on the mini’s :8780 listener. It runs as the gateway binary’s overlay-stdio subcommand (status, listeners, start, roll, –dry-run), started on the host by the roll recipes, and writes the gateway’s LaunchAgent and gateway.env.
crates/panel_templates Curated panels as Typst templates (ADR 0045): a panel is a folder under catalog/panels/<name>/ (template.typ, schema.json, sample.json, README.md). A producer fills typed data for a card’s template.v1 block;
crates/phone_core The phone app’s shared Rust core (ADR 0053 D2/D6; GPUI owns the phone app over this in-process core). It started as the PH1/PH2 spike’s phone-core (spikes/2026-11-06-phone-stack) and moved here in MB1.
crates/protocol Vulpine-protocol — the wire types every Fox9 component shares: the frontend ↔ gateway frames, the Admin requests and projections, and the decision.v1 types. TypeScript bindings are generated from these (just protocol-generate, ts-rs) into packages/protocol, which the frontends import.
crates/provider_publisher The public opaque PrivateRoot has no public constructor or root/policy/hash setter. Its admit(File) method selects compile-time package enrollment from kernel uname and revalidates root ownership and exact private mode. The internal S3 service admits canonical host descriptors;
crates/reach_iroh Reach over iroh (ADR 0053 addendum 2026-11-04). A detached crate: it has its own [workspace] and Cargo.lock, and the root Cargo.toml excludes it, so iroh never enters the gateway’s Cargo graph. It builds the vulpine-reach binary.
crates/realtime_stt_shim The STT worker wire in front of an OpenAI Realtime transcription server.
crates/sidecar_envelope Sidecar-envelope.v1 (draft; docs/contracts/sidecar-envelope.v1.md, ADR 0046 as amended 2026-10-18): the tree a sidecar window draws, sent as one Snapshot and then Patches.
crates/stt_shim_wire What the loopback shims in front of a user stt hardpoint share.
crates/update_guard Fail-closed checks around a Sparkle 2 update.
crates/vigil_serve Vigil-serve: Vigil’s installed build as a static page on loopback (the Python original, runtime/vigil-serve/vigil_serve.py, is deleted).
crates/visual_sandbox Script visuals (visual.v1; docs/contracts/visual.v1.md): the brain’s one-call visual as a Luau program, run in a sandbox on the gateway (the dry run, check) and again on every frontend that draws it (Visual).
crates/voice_gateway The Rust runtime core for Vulpine voice sessions: the crate, lib and binary vulpine-voice-gateway. just bootstrap and the roll install the binary on the gateway host at /bin/foxline-voice-gateway. The install is docs/install.md;
crates/vulpine_brain Vulpine-brain (brainctl before): the brain tool scripts that talk to the gateway’s owner-local Admin socket or the grant holder, as one Rust binary.
crates/vulpine_bundle_move The once-only move of an app’s per-bundle-id state (Application Support, WebKit storage) to its new bundle id, copy then mark, never deleting the old.
crates/vulpine_cli The vulpine CLI’s library (tool.v1 S5): the tool.v1 manifest, its lint, the call decode, the price, the golden calls and the semver bump, shared by vulpine tool check and, later, the gateway and ADR 0059’s extension-API suite.
crates/vulpine_client vulpine_client: the shell-neutral Rust client of the Voice Gateway.
crates/vulpine_disk_snapshot vulpine-disk-snapshot: the laptop’s daily disk growth snapshot, the Rust copy of runtime/disk_snapshot/disk_snapshot.py (the dua engine), byte-identical on the fixtures recorded from it (benchmarks/fixtures/disk_snapshot/, tools/repo/disk_snapshot_fixtures.py).
crates/vulpine_env Generated by tools/repo/vulpine_env.py from vulpine-env.toml; do not edit.
crates/vulpine_fleet Vulpine-fleet — the fleet adapter (ADR 0034 style: outside the gateway, fox9-owned names). Probes every host in the fleet manifest over bounded key-based ssh, labels ssh peers by fleet host, and emits one JSON snapshot line per interval on stdout for the gateway’s [fleet] task.
crates/vulpine_frigate_relay Vulpine-frigate-relay: Frigate’s review alerts, signed, to the gateway’s webhook intake (ADR 0051).
crates/vulpine_herdr Vulpine-herdr (herdrctl before): the herdr brain tools’ helpers as one Rust binary (slice 1 of the ADR 0041 §2 port of runtime/herdr_*). Each subcommand is the Python script of the same name, output for output on the recorded fixtures (benchmarks/fixtures/herdrctl/, tests/parity.rs):
crates/vulpine_home Vulpine-home (homectl before): the home bridge’s adapter, the Rust copy of homectl.py (retired/homectl/homectl.py for one release), byte-identical on the recorded fixtures (benchmarks/fixtures/homectl/, just homectl-fixtures compare, the cargo test tests/fixtures.rs).
crates/vulpine_onboarding CB11: the welcome window’s model, shared by the Glyph and the Admin.
crates/vulpine_provider Is an upstream model provider degraded? (d) The Rust providerctl, port 1 of ADR 0041.
crates/vulpine_relay One Rust relay for the laptop’s two relays to the mini (port queue rank 24): the Glyph’s loopback gateway ports (runtime/relay/glyph_gateway_relay.py) and the Admin’s socket (admin_gateway_relay.py) carried over ONE long-lived /usr/bin/ssh session per host, multiplexed by stream id on the Admin relay’s o…
crates/vulpine_room Vulpine-room (roomctl before) — one interface for “make this room say / play something”: the gateway’s room-speaker route and the brain tool pi_room_speak both run it.
crates/vulpine_spans The span layer for Vulpine’s Rust components, on fastrace 0.7.19.
crates/vulpine_vision Vulpine-vision (visionctl before): “who is there?” for one camera, as a verb with a receipt (ADR 0034 adapter tier).
crates/vulpine_wechat vulpine-wechat (wechatctl before) — the WeChat send channel’s control plane.

tools/

folder what it is
tools/acoustic Acoustic evidence: barge-in, echo, end-of-turn and AEC analysis over archived session PCM and public corpora, the far-field sweep, and the AEC weight preparation the gateway build uses. Run by hand where the audio lives (the private tree on the archive volume); receipts carry aggregates only.
tools/agents Agent-side hooks for the fleet of coding agents fox9 watches and dispatches: the presence hook receiver, the tripwire guard for agent lanes and the hard deny layer for agent shells. Claude Code and codex call fox9-hook from their hook tables so the gateway’s fleet probe can see each agent’s state;
tools/alias_arm The alias-over-media level ratio, an offline scorer for the gateway’s stt_alias_arm rows. It decides whether an alias “Fox9” that is not at the head of an utterance sits at a level consistent with the surrounding media run (refuse) or stands out (still arms), by ruling; shadow-log first.
tools/ambient cut_windows.py cuts 30 s room-audio windows from the archived session PCM for the ambient-caption spike.
tools/approvals approvalctl.py is a shell client for fox9’s owner-local approval socket: it asks the operator for an approval and blocks until the operator answers by voice, a policy, a grant or learned trust answers, or the deadline passes (no answer is a no).
tools/apps Measurement tools for the desktop frontends (Glyph, the Admin, and any native-shell spike), so a frontend choice starts from numbers taken by one method (the ui5 vet, docs/implementation-reviews/notes-vet-ui5-2026-10-14.md).
tools/architecture_maps gen_house_html.py renders the house-integration component map (the architecture JSON and its HTML page under docs/architecture/) in the same style as the speech-revision map. The JSON is the diagram source and the HTML is derived. The operator or a lane runs it by hand when the house map changes.
tools/attended_redecode Offline re-decode and scoring scripts for the attended pass, run on the corpus host. redecode_driver.py cuts per-take windows from the session dump and decodes each through the authoritative deployment decoder (one fresh worker per take, production supervisor settings);
tools/audio Process-tap capture: tapctl records what the Mac is playing through a Core Audio process tap, with no driver and no Screen Recording grant, and prints one JSON receipt. The operator or a lane runs it by hand.
tools/brain Probes for the voice brain (pi): the first-tool data and the first-token A/B. first_tool_pairs.py extracts (prompt, first tool or none) per voice turn from pi’s session files and reads the next-tool shadow zero-shot against them;
tools/brand svg_audit.py audits the Vulpine logo masters under assets/brand/ with the standard library only. Live and embedded rasters FAIL; straight edges 0.3-3 degrees off a clean angle, sub-shapes under 1/48 of the canvas and white fills that fake a knockout WARN; anchor counts, strokes and opacity are INFO.
tools/capture vulpine-record (was recordctl) is the capture recorder’s platform half (CC2): it records a window or a region with ScreenCaptureKit and the microphone, shows the ⇧ marks over it while it records, and leaves the raw recording that crates/capture_record makes into a…
tools/catalog The Catalog index (ADR 0024 §1 and §3, placement question 3; the 2026-10-11 addendum records who owns it). One typed, derived file, tools/catalog/index.json, lists every package the repository offers: its kind, id, declared version, root, entry points and a digest over those entry points.
tools/compact_lane_bench Measures TTFT, decode tok/s and JSON-schema adherence of a GGUF model loaded in-process by node-llama-cpp on Metal, against the Apple Foundation Models compact lane (~0.3 s first token, ~150 tok/s on the mini).
tools/denoise denoisectl is the streaming GTCRN speech enhancer as a fox9 adapter: a WAV in, a denoised WAV out, and one JSON receipt with the per-frame cost and where Core ML put the graph. It has no authority; it is the measurement tool for whether denoising in front of the Parakeet lane helps the decode.
tools/dictation Laptop-side models and readers for hold-to-talk dictation: the streaming commit stabilizer’s reference model, the guard set for any model tidy, and the hold latency reader.
tools/dlz_spike Read/write feel-test for the Mackie DLZ Creator XS over its LAN Socket.IO protocol (port 80, event “message”; INIT dumps ~3.6k flat keys; writes are {“”: value} echoed back on change). Needs bun add socket.io-client@4.
tools/docs The docs tooling: the checker every Markdown hook runs, the generated references and the agents’ flat index, the docs site’s stager and its search eval, and the changelog fold.
tools/earcons Original earcons for the phone’s push-to-talk moments, synthesized with the standard library only: press, go, sent, reply incoming, reply ended, still thinking (one soft sound the phone repeats every 2.8 s), error, channel joined and channel left, each in four families (radio, sparkle, fox, t…
tools/emobank gate.py is the emobank intake gate: dependency-free technical checks on voice reference WAVs. It runs nine thresholds lifted from a voice-dubbing rule set over every WAV in a directory, refusing clipping, continuous residual energy and wall-to-wall speech; it never judges identity or emotion.
tools/eval Evaluation forms and TTS quality: the one standard form every fox9 evaluation writes, transcript scoring for the evidence harness, the render-QA gates and prosody columns, the blind TTS A/B server and the TTS structural, truncation and verbalizer checks.
tools/feedback feature_requests.py brings the brain’s unmet asks back into development. An unmet ask is something the operator asked for that vulpine could not do yet. The brain logs it with pi_feature_request, on its own or because the operator asked it to.
tools/feeds feedctl.py is the headless feed store behind the brain tool pi_feeds.
tools/fleet The fleet tools: the Fleet adapter that probes the operator’s hosts for the gateway, and the compute-residency instruments that say which process holds a host’s GPU, CPU and Neural Engine. None of them runs inside the gateway, and only the WARP beacon’s install writes to a host.
tools/focus focusctl.swift reports what the operator has focused and selected as one bounded JSON receipt, read through Accessibility. It gives the focused element’s role, the selection, the caret range and the secure-input state; never a picture, a keystroke or a write.
tools/gateway Gateway operation from the laptop or the mini: live probes, the exact-line config patcher, the deploy planner, the fault injector and the bridges the operator or the orchestrator runs by hand or through a recipe. None of them is spawned by the gateway (those helpers live in runtime/);
tools/globe globectl reports the Globe/fn key as press and release lines: a listen-only event tap on the fn flags change, one JSON line per transition, plus hands-free (double-tap or hold+Space) and discard (Esc) events for dictation. Glyph supervises it as a child with –exit-on-stdin-eof.
tools/glyph reads_v498.py scripts the v498 reads that need no voice from the laptop Glyph (glyphctl) and judges each on the rows the gateway wrote to the open session’s trace on the mini: minutes, recall, fleet status and dictation. It reads the trace back over ssh, read-only.
tools/harness The test harness’s spine: just harness lite|full runs the suites of one manifest and writes one receipt with one verdict. The guide (tiers, suites, verdicts, the receipt, regressions, slots) is benchmarks/harness/README.md.
tools/house Dogs read as people on a camera: the Frigate label probe (receipt, rebuilt).
tools/install Create what a fox9 install needs on disk before its models and secrets: just bootstrap (ADR 0041 §3).
tools/lexicon Dry-run proposers that suggest lexicon entries from corrections the operator has already made; nothing here writes a lexicon or live config.
tools/live measure_turns.py turns gateway session traces into live armed-turn evidence: aggregates only, no utterance text.
tools/mail gmail_auth.py is the one-shot Gmail sign-in that the brain’s pi_mail tool reads. It runs an OAuth authorization-code flow with PKCE for the gmail.readonly scope only, asks for offline access so Google returns a refresh token, and writes ~/.config/foxline/gmail-token.json owner-only (0600).
tools/meet The Google Meet local path: meetctl, the capture adapter that spools a call’s two legs (microphone near, the browser’s output far, through a Core Audio process tap) as silence-aligned windows, decodes and merges them into meeting.v1 events (ADR 0039);
tools/memory_spike Spike scripts and fixtures for project-memory retrieval: a semantic evidence-floor experiment and the eval’s query sets.
tools/messages msgctl.py is the operator’s iMessage channel: it sends one text to the operator’s own handle and lists who messaged since a given time. It is an adapter outside the gateway (ADR 0034) in Python 3.9 stdlib, and every command prints one JSON line.
tools/notes_vet The scripts and records of the _notes tech-vet cycle: per-vet orchestrator scripts, batch inputs, machine output and reviewer briefs, kept as a record of each vet. 464 tracked files as of 2026-10-16 (659 before that day’s move of the reports to the vet archive); this README groups them by kind instead of listing each.
tools/patches Source patches fox9 carries against upstream projects whose sources are not vendored here. qwentts.cpp-stream-ramp-cap.diff adds QWENTTS_STREAM_MAX_FRAMES to qwentts.cpp’s streaming pipeline, capping how far the codec chunk size ramps up so first-audio latency can be traded against chunk count.
tools/permcard permcard is the welcome window’s drag card. The operator, after his first live onboarding on 2026-10-23: “i had to manually add the app, not the nice flow like scrawl where the app shows up below to drag into the permissions screen”.
tools/qa The tooling for fox9’s feature QA: the section-gated read server, the offline scorer, the unattended replay lane, run comparison and collection, and the QA-only switches for recording and the screen host.
tools/repo Repo tooling (ADR 0041 §1): the checks and generators that keep the repository itself honest, as opposed to the operator tooling in the other tools/ folders. These tools define repository checks, their runners and reports; none runs at runtime on any host.
tools/retrieval embedctl.swift is an adapter that turns text into vectors with Apple’s on-device sentence embedding (NLEmbedding, English): text in, JSON vector out, no model download and no RAM beyond the framework’s own (ADR 0034 shape).
tools/satellite Operator tooling for the Voice PE satellite puck: the installer for its bridge’s launchd job on the mini, and the Home Assistant helpers used to pair it on delivery day (2026-09-15). The operator runs these by hand; the bridge itself is apps/satellite-esphome.
tools/scarlett_spike A throwaway Rust spike that drives the scarlett2 vendor protocol of a Scarlett 2i2 3rd Gen over libusb on macOS, with no Focusrite software. It is run by hand to test mic-side hardware controls (phantom power, direct monitor, air, level); it never sends the save command, so nothing persists to the device.
tools/scenario_lint A standard-library linter that validates benchmarks/scenarios/.toml against the Step and EventMatcher schema in crates/voice_gateway/src/scenario.rs, without a compiler. It exists because an unmatchable event name is not an error in the Rust engine (the matcher ends in _ => false), only a wait that times out;
tools/set_input A single C program (set-input.c) that sets the macOS default input device by partial name match, or, given no argument, lists the input-capable devices with the default marked. It is run by hand on a Mac through CoreAudio; there is no recipe and no test.
tools/site record_showcase.ts records the silent showcase clips for the landing page in apps/site. Run it as just apps::site-media <glyph|vigil> :
tools/speech Second-opinion speech decoders and their corpus driver: each decoder takes the gateway second-opinion lane’s command line and prints the receipt line its parse_receipt reads.
tools/tart_qualification tart_qualification.py and its inert data: a source inventory and .py.txt template files retained from the ADR 0024 reconciliation workbench. The tool renders and checks qualification inputs from them; nothing here is imported or runnable, and nothing launches a runner or mints admission.
tools/tcc A Swift probe that asks which process macOS TCC judges for a command-line binary, and whether a bare signed CLI can hold its own microphone grant.
tools/telemetry A read-only reader (turn_decompose.py) that decomposes per-turn latency from the rust-gateway trace JSONL files.
tools/testbed The harness testbed: an isolated test gateway and a test-profile Glyph that every harness suite drives instead of the operator’s live stack.
tools/tts_lexicon Corpus readers that gate the TTS text front end on data: they count what the voice was actually handed, in the render receipts, before anyone sizes an abbreviation table or a lexicon batch. Run by hand against a directory of render receipts (.json with a text field).
tools/tts_pron_audit The pronunciation audit for the Qwen3-TTS voice. A word is rendered inside carrier sentences, read back by speech recognizers, and the stretch of each transcript where the word should be is turned into phones and compared with the reference phones;
tools/turnboard The turnboard tooling: the runner and scorers for the per-version turn regression suite, plus trace replays that read real gateway sessions.
tools/upstream_drift upstream_drift.py and its pin data: the upstream drift detector for pi and herdr. pins.json records the herdr API schema pin (version, protocol, schema digest) and the pi file pins;
tools/verbs The decision model’s laptop-side tools: the router heads, the scorecard that judges every candidate, the oracle reads, the trainers and data builders, and the converters that move a model to another runtime.
tools/verification The isolated-execution, provider-archive and qualification helpers of the ADR 0024 verification lineage that no reviewed byte pin names by path.
tools/voice_memos memoctl.py, the phone reach rung 0 adapter: a Voice Memo recorded on the phone or watch becomes a brain turn or a note. It is an adapter outside the gateway (ADR 0034), Python 3.9 stdlib, that watches a configured directory (never a default one) and keeps its own state.
tools/wake_scoring Scoring and replay tools for the wake and barge lanes: they turn an archived read into the standard KWS and VAD forms and replay wake detectors and echo cancellers over archived sessions. They are run by hand on the laptop, alone, against the session archive;
tools/wyoming_tts fox9’s voice as a Home Assistant TTS engine over the Wyoming protocol, with its first-audio measurement.

Was this page helpful?