@holoscript/cli

Command-line interface for HoloScript development.

Installation

npm install -g @holoscript/cli

Commands

Build / Compile

Compile HoloScript files to target platforms:

holoscript build src/
holoscript build --target web --output dist/
holoscript compile scene.holo --target unity

Parse & Validate

holoscript parse scene.holo
holoscript validate src/
holoscript ast scene.holo          # Show AST output

Run & Dev

holoscript run scene.holo          # Execute headless
holoscript repl                    # Interactive shell
holoscript watch src/              # Watch for changes
holoscript headless scene.holo     # Headless runtime

Package Management

holoscript add @holoscript/std
holoscript remove @holoscript/std
holoscript list                    # List installed packages
holoscript pack                    # Package assets
holoscript unpack bundle.hsa       # Unpack assets

Registry & Publishing

holoscript publish                 # Publish package
holoscript login                   # Authenticate
holoscript logout                  # Sign out
holoscript whoami                  # Show identity
holoscript access grant user pkg   # Manage access
holoscript org create my-team      # Organization management
holoscript token create            # Token management

HoloGram — 2D → 3D Bundle

Convert a still image, GIF, or video into a content-addressed HoloGram bundle (depth map + normal map + optional quilt/MV-HEVC/parallax render targets):

# Depth-only bundle (no render targets — Sprint 0a)
holoscript hologram photo.jpg --targets ''

# Full bundle with all render targets (requires hologram-worker — Sprint 0c)
holoscript hologram photo.png --targets quilt,mvhevc,parallax

# Custom output directory
holoscript hologram clip.mp4 --out ./my-bundle --targets quilt

# Named bundle (label stored in meta.json)
holoscript hologram avatar.webp --name "My Avatar"

The bundle is written to ./hologram-<hash>/ by default. Pass --out <dir> to override. The directory name encodes the full content hash so bundles are self-verifying.

Code Tools

holoscript traits                  # List available traits
holoscript suggest scene.holo      # Get code suggestions
holoscript generate "a VR lobby"   # AI code generation
holoscript templates               # Show available templates
holoscript inspect output.js       # Inspect compiled output
holoscript diff a.holo b.holo      # Show differences

Deployment

holoscript deploy scene.holo       # Deploy to remote
holoscript monitor                 # Monitor runtime
holoscript wot-export scene.holo   # W3C Web of Things export

Configuration

Create holoscript.config.json:

{
  "$schema": "https://holoscript.net/schemas/config.v3.json",
  "version": 3,
  "compiler": {
    "target": "web",
    "strict": true
  }
}

License

MIT