Introduction to HoloScript

HoloScript is a full programming language for VR, AR, robotics, IoT, and digital twins. It compiles from one source file to multiple registered targets (Unity, Unreal, Godot, visionOS, Android XR, WebGPU, URDF, SDF, DTDL, WoT, OpenUSD, and more).

🚀 Start with Studio (Recommended)

No coding required! HoloScript Studio is a web-based IDE powered by Brittney AI that lets you build VR scenes using natural language.

New User? Start Here

1. Your First AI Scene (15 min) - Build a complete VR scene with Brittney AI
2. Building Your First AI NPC (30 min) - Create intelligent characters
3. Studio IDE Reference - Complete interface guide

Studio Features

• 🎨 Creator Mode - AI-driven scene building (no code)
• 🖌️ Artist Mode - Visual shader graph editor
• 🎬 Filmmaker Mode - Cinematic camera paths
• 🦴 Character Mode - Import & animate characters
• ⚙️ Expert Mode - Full code editor for advanced users
• 🤝 Real-time Collaboration - Multi-user editing with CRDT
• 📤 One-click Publish - Share scenes with a URL

Launch Studio →

---

Why HoloScript?

For Humans

• No syntax errors - Visual/declarative approach eliminates brackets and semicolons
• Universal input - Voice, gesture, gaze, or traditional keyboard
• See the data flow - Watch computation happen in 3D space

For AI

• Visual understanding - AI "sees" program structure
• Native manipulation - AI can place and connect objects naturally
• Any output target - Generate code for any platform

For Computing

• One source → many targets - verify current target keys in ExportTarget (packages/core/src/compiler/CircuitBreaker.ts)
• 50,000 → 500 lines - Declarative syntax eliminates boilerplate
• Cross-domain - VR, AR, robotics, IoT, and digital twins from one source
• Dual parser - TypeScript + Rust/WASM with full LSP, linter, and formatter

File Formats

HoloScript uses three file formats:

Extension	Purpose	Best For
.hs	Classic HoloScript	Simple prototypes, learning
.hsplus	HoloScript Plus	VR traits, networking, physics
.holo	Composition	AI-generated scenes, full worlds

Quick Start

Install the VS Code extension:

ext install holoscript.holoscript-vscode

Create your first scene:

composition "Hello World" {
  environment {
    skybox: "gradient"
    ambient_light: 0.5
  }

  object "Cube" {
    @collidable
    position: [0, 1, -3]
    color: "#00ffff"
  }
}

Next Steps

• Publishing & platform terms - VRChat, Unity, Unreal, Godot, web, mobile: official terms links before you ship
• Quick Start Guide - Build your first HoloScript app
• File Formats - Deep dive into .hs, .hsplus, and .holo
• Traits Reference - trait categories and usage patterns (inventory changes over time)
• Working Tree Triage - Keep large local change sets cleanly scoped
• Release Versioning - Version policy and current release info
• MCP Mesh Operations - Health checks and first-response recovery
• Metrics SSOT - Canonical commands for targets/tools/traits/package counts