Home

Beez Wiki

Beez is a build and task orchestrator. Projects define pipelines in a Lua DSL (build.lua). Beez runs them with parallelism, caching, and a progress UI.

Quick links

I want to...	Start here
Understand how Beez works	Fundamentals
Write a build.lua	Lua DSL
Use beez.fs, beez.net, etc.	Lua API Overview
Configure Beez	Configuration
Understand caching	Caching
Understand phases and scopes	Phases and Scopes
Look up CLI flags	CLI
Scaffold a new project	Project Scaffolding
Tune terminal output	UI and Output
Contribute to Beez	Development and Contribution
Look up a term or flag	Appendix

Chapters

• Fundamentals - Core concepts, project layout, first pipeline
• Configuration - global, project, env, performance, cache, UI
• CLI - commands, flags, phases, steps, completion
• Lua DSL - build.lua reference: steps, tasks, workflows, ctx
• Phases and Scopes - selection, workflows, CLI, design patterns
• Caching - step cache, success cache, invalidation
• UI and Output - output modes, progress, themes, summaries, logs
• Development and Contribution - build, tests, QA, PR workflow
• Appendix - glossary, quick reference, troubleshooting, full index
• Recipes (coming soon)