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.
Install the official drun language support extension from your editor's marketplace:
We support Visual Studio Code, and any fork that has access to the OpenVSX store, like Cursor, Antigravity, etc.
Using a JetBrains IDE? Install the official drun language support extension directly from the JetBrains Marketplace:
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.