Skip to content

Command surface duals (intentional)

Some behaviors exist in more than one place by design:

SurfaceNotes
vox ci no-dei-import vs scripts/check_vox_cli_no_vox_orchestrator.shRust command is canonical (no-vox-orchestrator-import remains an argv alias).
vox ci mesh-gate vs scripts/populi/mens_gate_safe.* / legacy gate shellsRust command is canonical (mens-gate remains an argv alias).
vox ci cuda-features vs scripts/check_cuda_feature_builds.shRust command is canonical; shell script is an optional thin delegate.
vox ci build-timingsWall-clock cargo check for default vox-cli, GPU+stub, optional CUDA (when nvcc on PATH or via CUDA_PATH/CUDA_HOME), and with --crates extra per-crate lanes (--json supported). Soft budgets: docs/ci/build-timings/budgets.json; VOX_BUILD_TIMINGS_BUDGET_WARN / VOX_BUILD_TIMINGS_BUDGET_FAIL; pair latest.jsonl with snapshot-metadata.json. GitHub ci.yml runs build-timings --crates; no shell dual required.
vox ci toestub-scoped vs vox stub-check** vs toestub binaryCI uses vox ci toestub-scoped (fixed default root). vox stub-check is the interactive / full-flag path. The toestub crate binary remains for embedding.
vox run --mode script vs vox scriptSame script runner; vox script exposes sandbox / cache / isolation flags explicitly.
vox mens train vs vox trainCanonical native training is vox mens train. vox train --provider local bails with the exact vox mens train --backend qlora … command (no train_qlora.vox). vox train --native remains a legacy Burn scratch path when built with mens-dei.
vox mens train-uv vs vox mens train --backend qloratrain-uv is retired (bails). Canonical QLoRA is vox mens train.
vox fabrica / vox mens / vox ars / vox recensio vs flat build, doctor, snippet, review, …Same dispatch as the legacy top-level verbs; Latin names are discoverability aliases (see cli.md).
vox doctor vs vox diag doctorCanon: vox doctor (English). Latin lane: vox diag doctor — same code path; registry tags both under latin_ns: diag for the top-level doctor command (see nomenclature migration map).
vox completions <shell>Shell completion output (bash/zsh/fish/powershell/elvish); no script dual required.

There is no vox clean subcommand; benchmarks and docs must not assume one — clear caches by deleting the relevant dirs (e.g. ~/.vox/script-cache*) or use feature-specific tooling.