Getting Started
1.
Vox: The AI-Native Programming Language
2.
Getting Started with Vox
Journeys
3.
Journey: Building Resilient AI Agents
4.
Journey: Reliable Background Workflows
5.
Journey: One-File Full-Stack Data
6.
Journey: Native Rust LLM Training
Tutorials
7.
Tutorial: Building UI with Islands
8.
Tutorial: Building a Collaborative Task List
9.
Tutorial: Persistent Actors & State
10.
Tutorial: Workflow Durability
11.
Tutorial: first .vox app (checkpoints)
How-To Guides
12.
@py.import – Python Library Integration (torch, numpy, etc.)
13.
Contributing — Mens native training
14.
Contributing — Populi control plane
15.
Contributing — parser and HIR
16.
Ecosystem & Tooling
17.
Examples
18.
First Full Stack App
19.
Golden Examples Corpus
20.
How To: Train Mens on RTX 4080 Super
21.
How to use the canonical VoxDB / Codex store
22.
How-To: Build AI Agents and MCP Tools
23.
How-To: Deploy to Production
24.
How-To: Handle Errors Gracefully
25.
How-To: Islands and Pages
26.
How-To: Model Complex Domain Logic
27.
How-To: Publish Scientia findings
28.
How-To: Rust crate imports in Vox scripts
29.
How-To: Scale Actors
30.
How-To: System I/O and Capabilities
31.
How-To: Test Your Logic
32.
How-To: Testing Integration
33.
How-To: The Database Layer
34.
Model Routing & Provider Cascade
35.
Scientia publication: what you type vs what the system derives
36.
Troubleshooting FAQ
API Reference — Crates
37.
Known Documentation Gaps & Backlog
38.
Crate API: vox-ast
39.
Crate API: vox-codegen-rust
40.
Crate API: vox-codegen-ts
41.
Crate API: vox-dei-sandbox
42.
Crate API: vox-gamify
43.
Crate API: vox-hir
44.
Crate API: vox-lexer
45.
Crate API: vox-mcp
46.
Crate API: vox-orchestrator
47.
Crate API: vox-parser
48.
Crate API: vox-py
49.
Crate API: vox-typeck
50.
Crate API: vox-wasm
Examples
51.
Golden Examples: Working Vox Code
Explanations
52.
AI Agent Orchestration
53.
Actors & Workflows
54.
Compiler Architecture
55.
Explanation: Capabilities
56.
Explanation: Compiler Lowering Phases
57.
Explanation: Durable Execution
58.
Explanation: Security Model
59.
Explanation: The Vox Runtime
60.
Glossary: Vox Terminology
61.
Native ML Training Pipeline
62.
OpenClaw Competitive Analysis
63.
Rosetta Inventory: One Scenario, Four Languages
64.
Vox FAQ: Frequently Asked Questions
65.
Why Vox: Compiler-Verified AI Code
66.
README: Vox Platform (Scientia Draft, April 2026)
Architecture Decisions (ADRs)
67.
ADR 002 — Diátaxis Three-Tier Documentation Architecture
Architecture SSOTs
68.
Architecture index
69.
Compiler diagnostics and Rust codegen ergonomics
70.
Cross-repo querying and observability
71.
Language surface SSOT (keywords, decorators, manifests)
72.
OpenAPI contract SSOT (Populi, MCP, Codex)
73.
Outbound HTTP policy (reqwest / vox-reqwest-defaults)
74.
Vox source → compiler → Mens training (pipeline SSOT)
75.
Populi data pipeline (control plane vs Mens corpus)
76.
AI CLI Generation Standard
77.
Capability registry SSOT
78.
Capability visualization views
79.
MCP exposure from the Vox language (SSOT)
80.
Additive schema plan: scholarly external jobs and snapshots
81.
Anti-foot-gun planning standard
82.
CLI design rules SSOT
83.
CLI reachability SSOT
84.
CodeRabbit review coverage SSOT
85.
Compiler IR Pipeline
86.
Completion policy SSOT (LLM premature-completion)
87.
Dependency Sprawl Audit and Resolution (2026)
88.
Deployment Compose SSOT
89.
Doc-to-code acceptance checklist
90.
Document boundary matrix
91.
Document maintenance protocol
92.
Exception and deferral policy
93.
Fast LLM instruction plan
94.
Feature growth boundaries
95.
God object defactor checklist (v3)
96.
HITL Doubt Loop (SSOT)
97.
Hybrid adapter cookbook (SPA + SSR)
98.
IR emission SSOT (HIR, WebIR, VoxIrModule)
99.
Internal Web IR Implementation Blueprint
100.
Internal Web IR Side-by-Side Schema
101.
Interop tier policy
102.
Legacy retirement roadmap (2026)
103.
Ludus / gamify schema inventory (SSOT pointers)
104.
Ludus: scope and non-goals
105.
Maintainability hotspot matrix (baseline)
106.
Master planning index
107.
Mens lane segmentation research
108.
Mens training SSOT
109.
Milestone and gate definition spec
110.
Minimal React Interop Shell Strategy
111.
Mobile/Desktop Convergence & Language Extension Research 2026
112.
News syndication: incident patterns and mitigations
113.
Nomenclature migration map (SSOT)
114.
Operations catalog SSOT
115.
Orchestrator AgentEventKind → Ludus matrix
116.
Orchestrator multi-agent groundwork (2026)
117.
Plan adequacy — thin plans, external limits, and Vox mitigation
118.
Planning critique and gap analysis
119.
Planning meta exception register
120.
Planning meta maintenance log
121.
Planning taxonomy and glossary
122.
Populi GPU truth probe specification (NVML Layer A)
123.
Populi node lifecycle, drain, and GPU hotplug
124.
Question gate standard for planning
125.
Qwen 3.6 integration research (groundwork)
126.
Qwen3.5 Multimodal Phase 2 Backlog
127.
React interop full-repo migration charter (2026)
128.
React interop migration backlog (2026)
129.
Research baseline and source-of-truth map
130.
Rust ecosystem support SSOT
131.
SCIENTIA A2A evidence-gathering tasks
132.
SSOT / DRY convergence roadmap
133.
Scaling CI enforcement rollout
134.
Scaling audit baseline (workspace map)
135.
Scholarly publication: digest-bound approval invariants
136.
Script surface audit and Vox migration
137.
TOESTUB scaling rules (SSOT)
138.
Table metadata SSOT (Arca ↔ @table convergence)
139.
TanStack Start Codegen Specification
140.
TanStack Start Implementation Backlog
141.
Task catalog authoring spec
142.
Telemetry client disclosure SSOT
143.
Telemetry remote sink specification
144.
Telemetry trust boundary and SSOT map
145.
Trust Reliability Layer (SSOT)
146.
Unified News Syndication Security & Safety
147.
Vox Architectural Organization & Governance
148.
Vox Docker-backed portability implementation plan 2026
149.
Vox Docker-backed portability research 2026
150.
Vox Ludus integration contract (producers)
151.
Vox Memory System
152.
Vox RAG and Autonomous Research Architecture 2026
153.
Vox React/v0 Interop Research Findings
154.
Vox Security Model
155.
Vox Session Management
156.
Vox Web: Minimal React Interop Implementation Plan
157.
Vox bell-curve strategy
158.
Vox boilerplate implementation status
159.
Vox boilerplate reduction master roadmap
160.
Vox boilerplate research findings 2026
161.
Vox full-stack ergonomics deep dive
162.
Vox packaging full implementation plan 2026
163.
Vox packaging implementation blueprint
164.
Vox packaging research findings 2026
165.
Vox shell operations boundaries
166.
Vox web stack SSOT
167.
VoxDB connection policy (SSOT)
168.
VoxGiantia publication architecture (beginner map)
169.
Weighted deep planning manual
170.
Clavis V2: Full Implementation Plan (2026)
171.
Vox Publication and Orchestration Hardening: Implementation Plan 2026
172.
Research index
173.
Unified Agentic Control Surface Research
174.
Protocol convergence research 2026
175.
VCS for agent state and artifact snapshotting research 2026
176.
Syndication SDK Deep Research & Strangler-Fig Migration Plan 2026
177.
SCIENTIA impact, readership, and citation-adjacent signals (research seed)
178.
Prompt engineering, system prompts, document-skills, and SCIENTIA (research 2026)
179.
SCIENTIA publication-worthiness and SSOT unification (research 2026)
180.
SCIENTIA multi-platform ranking, discovery, and anti-slop SSOT (research 2026)
181.
Mens vision and multimodal inputs (research 2026)
182.
Mens Qwen family migration and native stack (research 2026)
183.
TOESTUB line limit and MENS corpus size research (2026)
184.
Vox corpus lab: mass examples, metrics, and eval harness (research 2026)
185.
2026 State-of-the-Art: Dynamic Agentic Planning & Orchestration
186.
AI Agent Context and Handoff Research
187.
AI IDE feature research findings 2026
188.
AI-Augmented Testing & Hourglass Architecture Research (2026)
189.
Agent Mesh Economics & Token Costs
190.
Agent Trust Reliability Evaluation
191.
Architecture Decision Checklist for Implementing Agent Handoff Continuity
192.
Architecture: ASR Speech-to-Code
193.
Automated Testing Research for the Vox Language
194.
Catastrophic Forgetting in QLoRA Fine-Tuning
195.
Clavis as a one-stop secrets manager: research findings 2026
196.
Clavis secrets, env vars, and API key strategy research 2026
197.
Cognitive Science and NLP: Constraint as Guide vs. Output Space Collapse
198.
Compiler Testing Research Synthesis
199.
Context management research findings 2026
200.
Continual Learning Flywheel Risks
201.
Cross-Agent Evidence Sharing in A2A Protocol Implementations
202.
Design Pattern Recommendations for Platform Gaps
203.
Diagnostic questioning — research synthesis 2026
204.
Documented Failure Modes: Context Bleed and Session Identity Confusion
205.
Empirical Evidence for Context Compaction Strategies
206.
Empirical Evidence: Strictly-Typed vs. Dynamically-Typed Languages
207.
Empirical Justification for Reward Weight Allocations in Code RL
208.
Evaluating AI Plan Adequacy Heuristics
209.
Evidence Base for Context Retrieval Policies
210.
Execution Time Budgeting and Agent Learning Research 2026
211.
GRPO Reward Shaping for Code LLMs
212.
GRPO and VRAM Efficiency: Architectural Comparisons and Small-Batch Dynamics
213.
Gap Analysis and Recommended Architectural Adjustments
214.
GraphRAG Iterative Retrieval Research 2026
215.
Internal Architecture Repository
216.
K-Complexity and Multi-File LLM Code Generation
217.
LLM Grammar Constraints for Code
218.
LLM Output Mediation and Programmatic Validator Generation
219.
LLM-Native Language Design
220.
Language Features Empirically Linked to LLM Code Generation Success
221.
Local Autonomous Research Findings 2026
222.
MENS Synthetic Corpus: Limitations and Mitigation Strategies (Research 2026)
223.
Minimum Viable Corpus Size for QLoRA Domain Adaptation
224.
Multi-repo context isolation: research findings 2026
225.
Populi GPU network research 2026
226.
Production Evidence: Context Truncation as a Silent Failure Mode
227.
Production Failure Mode Catalog with Mitigations
228.
Quality and Mode Collapse in Self-Play LLM Loops
229.
Research Synthesis: Grand Strategy Seed 2026
230.
Research: ASR Speech-to-Code Findings
231.
Research: Claude Code Ultraplan Architecture
232.
Research: Fuzzy & Partial Parsing
233.
Research: Phonetic Operators vs. Symbols
234.
Research: Planning Mode Capability Map
235.
Research: Planning Mode and Agentic Coding 2026
236.
Risk Taxonomy, Monitoring Design, and Open Research Questions
237.
Scientia Publication Endpoints — Ground-Truth Research & Implementation Policy (April 2026)
238.
State of the Art for Context-Aware Agent Handoff Protocols
239.
Telemetry unification research findings 2026
240.
Terminal AST validation research 2026
241.
Terminal execution policy research findings 2026
242.
The Compile-Pass Oracle and Semantic Degradation
243.
The Efficacy of Binary Parse-Rate as a Primary Reward Signal
244.
The Frontier: Unknowns in LLM-Native Language Design
245.
The Optimization Landscape of Positive-Only Training Loops
246.
The Risks of Agent-Generated Prose (Schola & Scientia)
247.
Utilizing Parse Failures as Negative Examples
248.
Vox Developer User Journeys: Intent vs. Actualization
249.
Vox Language Testing Pipeline
250.
Vox Scientia Gap Analysis (April 2026)
251.
Vox VS Code Extension — Frontend Redesign Research (2026)
252.
Vulnerabilities in AST-Based Coverage Scoring and Reward Hacking
253.
Works Cited: AI Agent Context and Handoff
254.
Works Cited: Continual Learning Flywheel Risks
255.
Works Cited: GRPO Reward Shaping
256.
Works Cited: Hallucination and Type-System Research
257.
agent handoff contract 2026
258.
cryptography research findings 2026
259.
cryptography ssot 2026
260.
orchestrator symphony research 2026
261.
scientia external discovery research 2026
262.
scientia pipeline ssot 2026
263.
scientia socrates unification research 2026
264.
SCIENTIA implementation wave playbook 2026
265.
Scientia Community Publishing Playbook 2026
266.
GUI, v0/islands, vision, and Mens Qwen — virtuous-cycle implementation plan (2026)
267.
Orchestrator task attachment_manifest (RFC 2026)
268.
MENS Corpus: Full Implementation Plan (2026)
269.
Clavis Cloudless Implementation Catalog
270.
Clavis Cloudless Threat Model V1
271.
Context management implementation blueprint
272.
Context management phase 1 backlog
273.
MENS Research Track Blueprint 2026
274.
Populi GPU mesh implementation plan 2026
275.
Scientia Publication Pipeline — Full Implementation Plan v2 (2026)
276.
Telemetry implementation backlog 2026
277.
Telemetry implementation blueprint 2026
278.
Telemetry retention and sensitivity SSOT
279.
Telemetry taxonomy and contracts SSOT
280.
Vox 0.4 Grand Migration Plan (Uncompressed)
281.
Vox Agentic Loop Overhaul + MENS Syntax-Intelligence Blueprint
282.
English-Core + Latin Alias Migration Ledger
283.
vox-dei HITL Redirect
Contributors
284.
Contributor hub
285.
Documentation governance
286.
Agent instruction architecture
287.
Coding Agent Instructions
288.
Continuation Prompt Engineering
CI & Quality
289.
CLI baseline metrics
290.
Documentation authority pointers
291.
Command compliance SSOT
292.
Doc inventory SSOT
Operations
293.
Clavis Break-Glass Runbook
294.
Clavis Cloudless Ops Runbook
295.
VoxDB data cutover and telemetry sidecar runbook
Reference
296.
ADR 001 — Burn Backend Selection for vox-tensor
297.
ADR 003 — Native Rust Training Over Python
298.
ADR 004: Codex over Arca over Turso
299.
ADR 005: Socrates anti-hallucination SSOT
300.
ADR 006: Mens full-graph Candle QLoRA with qlora-rs
301.
ADR 007: qlora-rs multi-layer training API (Phase 2c architecture gate)
302.
ADR 008: Mens transport
303.
ADR 009: Hosted mens / BaaS (future scope)
304.
ADR 010 — TanStack as the Vox web spine
305.
ADR 011: Scientia publication manifest SSOT
306.
ADR 012 — Internal Web IR strategy for Vox
307.
ADR 013 — OpenClaw WS-first native interop
308.
ADR 014: async-openai selective adoption (spike outcome)
309.
ADR 015: Vox Docker/OCI portability SSOT
310.
ADR 016: Oratio streaming Whisper and constrained decode
311.
ADR 017: Populi lease-based authoritative remote execution
312.
ADR 018: Populi GPU truth layering
313.
ADR 019: Durable workflow journal contract v1
314.
ADR 020: Populi mesh scaling — default transport posture
315.
ADR 021: Generated workflow durability parity
316.
ADR 023: Optional telemetry remote upload
317.
Acceptance runbook — Mens HF fine-tune convergence
318.
Agent Messaging & Orchestration Roadmap (Aspirational)
319.
Architecture Decision Records (ADR)
320.
Architecture Decision Records (index)
321.
Automation primitives
322.
Binary release artifact contract
323.
Boilerplate metrics and KPI framework
324.
CI runner contract
325.
CLI command surface (generated)
326.
CLI reference (redirect)
327.
CLI scope policy
328.
Changelog
329.
Clavis SSOT
330.
Codex / Arca compatibility boundaries
331.
Codex BaaS scaffolding
332.
Codex HTTP API
333.
Codex legacy migration
334.
Codex vNext — schema domains
335.
Codex, Arca, and Rust import policy
336.
Command compliance
337.
Command surface duals (intentional)
338.
Communication protocols
339.
Compatibility and deprecation windows
340.
Crate and build-lane migration map
341.
Crate hardening matrix (rolling)
342.
Crate topology buckets
343.
Cross-platform Vox — runbook
344.
Database Query Reference
345.
Deployment: Docker, Compose, Coolify, CI (SSOT)
346.
Deprecation policy — Mens native fine-tuning
347.
Diagnostic taxonomy (compiler)
348.
Direct turso:: usage allowlist
349.
Doc inventory verifier (SSOT)
350.
Docker image baselines (D05)
351.
Environment variables (SSOT)
352.
Environment variables (SSOT) (redirect)
353.
Environment variables SSOT filename (redirect)
354.
Explicitly out of scope for Rust migration
355.
External repositories & workspace SSOT
356.
Feasibility: full-graph Candle training (qlora-rs)
357.
Forward-only migration charter
358.
GitHub-hosted runner exceptions
359.
HF fine-tune gap matrix (SSOT ↔ code)
360.
HF fine-tuning capability matrix (code-grounded)
361.
HIR legacy AST wrappers (inventory)
362.
Hashing & Identity Builtins
363.
Human-In-The-Loop & Doubt
364.
Information-theoretic questioning protocol
365.
Installation Reference
366.
Language Syntax Reference
367.
Language ergonomics principles
368.
MCP HTTP gateway contract
369.
MCP HTTP read-role governance contract
370.
MCP tool registry contract
371.
MENS curriculum — speech-to-code stages
372.
MENS findings: Composer and Kimi (2026)
373.
Mens / HF fine-tune — LLM PR checklist
374.
Mens Architecture 2026 Synthesis
375.
Mens Cloud GPU Training Strategy
376.
Mens Coordination & Database Write Safety
377.
Mens Coordination Workflow Guide
378.
Mens LoRA / adapter ownership (vox-tensor vs vox-populi)
379.
Mens external technology options
380.
Mens laziness and accuracy audit
381.
Mens local serving SSOT (Schola + orchestrator)
382.
Mens measurement gap analysis
383.
Mens native training SSOT (Candle QLoRA–first; Burn LoRA deprecated in dispatch)
384.
Mens strategy inputs checklist
385.
Mens train defaults (generated)
386.
Mens training data (JSONL) contract
387.
Mesh / Populi SSOT (CPU-first)
388.
Migration metrics (script → vox ci)
389.
Migration: backend-centric flags → fine-tune contract
390.
Mobile and edge AI — SSOT
391.
OpenClaw Discovery and Sidecar SSOT
392.
Oratio & speech SSOT (Candle Whisper, no whisper.cpp)
393.
Orchestrator bootstrap factory and daemon boundaries
394.
Orphan surface inventory
395.
Package management migration (2026)
396.
Parser ambiguity and robustness inventory
397.
Parser feature matrix
398.
Phase 0 documentation baseline — signoff
399.
Populi overlay personal cluster runbook
400.
Populi remote execution rollout checklist
401.
Populi work-type placement policy matrix
402.
QLoRA Fine-tuning Data Strategy & SSoT
403.
Reference: Decorator Registry
404.
Reference: Type System
405.
Repo reconstruction benchmark ladder
406.
Research Notes: Achieving Serverless-like Performance with MCP
407.
Review Anti-Pattern Catalog Contract
408.
Review Fix Pairs Contract
409.
Review Regression Challenges Contract
410.
Rust ecosystem support contract
411.
Rust pattern modernization — Wave 0 baseline
412.
SCIENTIA SSOT handbook (glossary, vocabulary, checklists)
413.
SCIENTIA publication automation SSOT
414.
SCIENTIA publication readiness audit
415.
SCIENTIA publication worthiness rules
416.
Scientia publication failure playbook
417.
Searching the Documentation
418.
Socrates protocol — single source of truth
419.
Speech capture architecture (edge vs backend)
420.
Speech-to-code pipeline (Oratio → MCP → compiler → MENS)
421.
Speech-to-code — operations, security, rollout
422.
Standard Library Built-ins
423.
Standard Library Reference
424.
Standard library surfaces
425.
Syntax K complexity telemetry (WebIR + emit)
426.
TOESTUB self-healing architecture 2026
427.
TanStack SSR with Axum (development topology)
428.
TanStack web backlog
429.
TanStack web roadmap
430.
Tavily Integration SSOT
431.
Telemetry and research_metrics contract
432.
Testing Standard — SSOT
433.
Trim, build, and defer (feature lifecycle)
434.
TypeScript boundary policy
435.
Unified orchestration — SSOT
436.
VS Code extension and vox-mcp compatibility
437.
Vox Documentation Style Guide
438.
Vox Feature Builds & Capabilities
439.
Vox IR Specification
440.
Vox Skill Marketplace
441.
Vox Web Architecture Analysis
442.
Vox Webhook Integration
443.
Vox database language surface (canonical)
444.
Vox full-stack build artifacts — single source of truth
445.
Vox full-stack web UI — single source of truth
446.
Vox portability SSOT
447.
Web Model Reference
448.
Workflow enumeration (GitHub Actions)
449.
Workspace root Cargo.toml (fix forward)
450.
Zig-Inspired Deployment Architecture
451.
cli
452.
vox-cli build and feature inventory
453.
MCP tool reference (legacy path)
Light
Rust
Coal
Navy
Ayu
Vox: The AI-Native Programming Language
"Examples"
Examples