# Glyphae
> The 3D engine your AI drives: a CLI-native spectral path tracer where scenes are programs.
> If you are an agent, download the binary and run `glyphae --help-ai`: it prints a complete
> machine manual (scene format, viewport socket, render modes, quality policy).

## Index
- Agent integration (paste-ready CLAUDE.md block): https://glyphae.com/agents
- Getting started (install to first render): https://glyphae.com/start
- Download (macOS arm64, Linux x86_64, Windows x86_64, free): https://glyphae.com/download
- Docs (install, scenes, viewport, renders): https://glyphae.com/docs
- The engine (how it works): https://glyphae.com/engine
- Changelog: https://glyphae.com/changelog
- Release metadata (version, urls, sha256): https://assets.glyphae.com/releases/latest.json

## Driving the engine
- Scaffold a scene: glyphae --scene-new <recipe> work.scene
- Live viewport (hot-reloads on save): glyphae --view work.scene
- Viewport socket: newline-JSON on 127.0.0.1:7878 — ping, open, quality, snapshot, reset, play, time, clay
- Final frame: glyphae --render-scene work.scene out.png [spp] [w h]
- Validation tier: add --draft (spp capped, half resolution, volumes forced to march)
- Recipes: blank petrol emerald gem slab card carabiner zen can jelly tire avatar

## Rules for use
- A scene file is the source of truth: text, one key=value per line, deterministic.
- params.* regrows geometry; camera.* and scene.* only restart accumulation.
- Snapshot the viewport before claiming a visual result.
- Volumes have two transports: march (fast approximation) and path (ground truth). Offer both.