create-app

To generate a Lua app, describe your desired application in natural language and the tool reads the DEVICE-SKILL.md and sandbox docs to produce validated Lua source code. It outputs the runnable Lua source to a file or stdout without pushing to a device.

Yes, you can pass optional reference files via the --ref option to augment context. The generator reads these files alongside sandbox documentation to tailor the Lua source to specific hardware or tutorials.

No, the generated Lua app is not pushed to the device. The tool outputs the validated Lua source to a specified file using --out or to stdout, allowing you to review and deploy it manually.

The tool validates the generated Lua source by running it through the existing validate-app workflow. This ensures the produced code adheres to correct APIs and lifecycle behavior defined by the sandbox documentation.

To ensure correct device APIs, the tool automatically resolves the device Lua surface from DEVICE-SKILL.md and reads embedded sandbox documentation. This process informs the code structure and validates the final Lua source.

Yes, you need a DEVICE-SKILL.md file, which can be provided explicitly via --device-skill or fallback to ./DEVICE-SKILL.md. The tool reads this file to understand the Lua surface and ensure correct API usage in the generated app.