drun is a semantic task automation language for readable project workflows.

xdrun is the CLI that executes .drun task files. It is designed for automation that reads closer to intent than shell glue, while still running the commands your project needs.

Use the install script:

curl -sSL https://raw.githubusercontent.com/phillarmonic/drun/master/install.sh | bash

Install a specific version:

curl -sSL https://raw.githubusercontent.com/phillarmonic/drun/master/install.sh | bash -s v2.10.0

The installer detects platform and architecture, installs xdrun, and attempts to make it available on your PATH.

Create .drun/spec.drun:

version: 2.0

task "hello" means "Say hello":
  info "Hello from drun"

Or run this command to initialize a Drun spec file in the current directory (a folder named .drun will be created). The drun demo file also includes a task named hello.

xdrun --init

Then run it:

xdrun hello

List tasks:

xdrun --list

Dry run a task:

xdrun hello --dry-run

Task parameters use key=value syntax:

xdrun deploy environment=production version=v1.2.3

• Define build, test, and release workflows in a readable DSL.
• Replace ad hoc shell scripts or large Makefiles with named tasks.
• Add validation and defaults to task parameters.
• Share deployment and environment operations in a form non-authors can still review.
• Manage multi-service local stacks and orchestration flows.

• English-like task syntax.
• key=value task parameters with CLI flags kept separate.
• Built-in validation, defaults, and control flow.
• Dry-run support for inspecting execution.
• Optional run ... attached mode for REPL-style commands that need stdin and a terminal.
• Reusable task files and examples for common workflows.
• Orchestration support for multi-service projects.

Use attached when a run command must stay connected to your terminal, such as REPLs or tools that prompt for input:

task "repl":
  run "go run command" attached

Plain run "command" remains non-interactive and is still the default for ordinary automation steps.

• Usage and troubleshooting: docs/USAGE_AND_TROUBLESHOOTING.md
• Language reference: DRUN_V2_SPECIFICATION.md
• Examples: examples/README.md
• Orchestration: docs/ORCHESTRATION.md
• Stateless and partial names: docs/STATELESS_AND_PARTIAL_NAMES.md
• Developer documentation: DEVELOPER_GUIDE.md
• Architecture: ARCHITECTURE.md