drun documentation¶
drun is a readable automation language executed by the xdrun CLI. This site is the canonical home for its user guides, technical language specification, examples, and contributor documentation.
Choose your path¶
- New to drun? Follow the getting started guide, then browse the examples.
- Writing Drunfiles? Use the language specification and built-in actions.
- AI Integration? Check out how to use the drun skills on your AI agent.
- Orchestrating services? Follow the orchestration guide, with the normative details in the orchestration specification.
- Contributing? Read the developer guide, architecture guide, and contribution workflow.
Documentation structure¶
| Area | Purpose |
|---|---|
| Getting started | Installation, CLI usage, configuration, and troubleshooting |
| Language specification | Normative syntax, semantics, runtime behavior, and built-ins |
| Guides | Task-oriented workflows and feature walkthroughs |
| Examples | Complete Drunfiles and usage patterns |
| Development | Architecture, packages, testing, and contribution guidance |
The language reference deliberately keeps its technical specification style. It is split by concern so each page is searchable, linkable, and small enough to navigate comfortably.