CLI & AI tools Command reference helix bridge Universal, plugin-driven import pipeline for assets, characters, scenes, and engine projects
CLI version 0.1.27-helix3.551. Run helix bridge --help for the text your installed build prints.
Universal, plugin-driven import pipeline for assets, characters, scenes, and engine projects
Fingerprint a source and identify its engine, format, and likely content domain
helix bridge detect [options] < source > Argument Required Description sourceyes file, project directory, or a .zip of one (extracted safely to a temp dir)
Option Description --jsonprint the machine-readable detection record
Inspect a source and show its detected structure plus viable import goals
helix bridge inspect [options] < source > Argument Required Description sourceyes file, project directory, or a .zip of one (extracted safely to a temp dir)
Option Description --plugin-dir <paths...>also discover local plugins from these directories --jsonprint machine-readable inspection and plans
Resolve installed plugin capabilities into a deterministic conversion graph
helix bridge plan [options] < source > Argument Required Description sourceyes file, project directory, or a .zip of one (e.g. a BeamNG mod as downloaded; extracted safely to a temp dir)
Option Description --type <type>auto, asset, character, addon, scene, animation, or extract (default "auto") --target <target>web, unreal, mobile, or canonical (default "web") --plugin <ids...>restrict non-built-in plugins to these installed ids --plugin-dir <paths...>also discover local plugins from these directories --head-texture <image>MetaHuman face baked head texture --eye-texture <image>MetaHuman baked eye texture override (default: packaged canonical bake from PR #99) --canonical <glb>canonical helix-humanoid body override --map <json>custom skeleton/bone map --input <name=path...>immutable named plugin input; repeat for multiple inputs (BeamNG: palette=<palette.json>, beamngCommon=<index.json>, beamngEngine=<engine.json> with {"cylinders": N} to override the derived cylinder count) --jsonprint the machine-readable plan
Detect, plan, convert, validate, package, and write deterministic provenance
helix bridge import [options] < source > Argument Required Description sourceyes file, project directory, or a .zip of one (e.g. a BeamNG mod as downloaded; extracted safely to a temp dir)
Option Description --type <type>auto, asset, character, addon, scene, animation, or extract (default "auto") --target <target>web, unreal, mobile, or canonical (default "web") -o, --output <directory>empty output directory (default "./bridge-out") --plugin <ids...>restrict non-built-in plugins to these installed ids --plugin-dir <paths...>also discover local plugins from these directories --head-texture <image>MetaHuman face baked head texture --eye-texture <image>MetaHuman baked eye texture override (default: packaged canonical bake from PR #99) --canonical <glb>canonical helix-humanoid body override --map <json>custom skeleton/bone map --input <name=path...>immutable named plugin input; repeat for multiple inputs (BeamNG: palette=<palette.json>, beamngCommon=<index.json>, beamngEngine=<engine.json> with {"cylinders": N} to override the derived cylinder count) --expect-plan-key <sha256>execute only if the freshly resolved plan has this exact key --allow-permission <permissions...>permissions approved for community/local plugins; repeat or comma-separate --dry-runplan only; write and execute nothing --keep-stagedebug only: preserve the .bridge-stage-<uuid> transaction directory on failure instead of deleting it (also HELIX_BRIDGE_KEEP_STAGE=1) --allow-untextured-body-geometrycharacter add-ons only: package even if the leftover base-body/underwear trip line fires. Use only after confirming the flagged surface is a real garment panel (see bodyGeometryGuard.ts MEASURED PRECISION) --jsonprint the machine-readable result
Validate a Bridge output, provenance record, or combined base-avatar GLB
helix bridge validate [options] < artifact > Argument Required Description artifactyes artifact or bridge-provenance.json
Option Description --base-avatarrequire the three-LOD base avatar contract with textured eyes --jsonprint machine-readable validation
Report installed Bridge plugins and optional engine/tool adapters
helix bridge doctor [options] Option Description --plugin-dir <paths...>also inspect local plugins from these directories --jsonprint machine-readable diagnostics
Create, inspect, install, test, list, and remove Bridge Plugins
helix bridge plugins < comman d > List built-in and installed Bridge Plugins
helix bridge plugins list [options] Option Description --plugin-dir <paths...>also discover plugins from these directories --jsonprint machine-readable plugins
Validate and inspect a plugin directory or installed plugin id
helix bridge plugins inspect [options] < plugin > Argument Required Description pluginyes plugin directory, manifest path, or installed plugin id
Option Description --jsonprint machine-readable inspection
Validate and atomically install a local Bridge Plugin
helix bridge plugins install [options] < directory > Argument Required Description directoryyes plugin directory containing bridge-plugin.json
Option Description --forcereplace an already-installed plugin with the same id
Remove an installed community/local Bridge Plugin
helix bridge plugins remove < i d > Argument Required Description idyes installed plugin id
Scaffold a local Bridge Plugin with the versioned SDK contract
helix bridge plugins create [options] < directory > Argument Required Description directoryyes new empty plugin directory
Option Description --id <id>stable lowercase plugin id (required) --name <name>display name
Validate a Bridge Plugin manifest, file bounds, and command handlers
helix bridge plugins test [options] < directory > Argument Required Description directoryyes plugin directory
Option Description --jsonprint machine-readable inspection