commandbox-task-runners

Automate CommandBox task orchestration with CFML task definitions and lifecycle hooks.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ortus-boxlang/skills --skill commandbox-task-runners-ortus-boxlang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commandbox-task-runners
Source: https://github.com/ortus-boxlang/skills/tree/main/commandbox/commandbox-task-runners
Command: npx skills add https://github.com/ortus-boxlang/skills --skill commandbox-task-runners-ortus-boxlang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates CFML/BoxLang task automation for builds, migrations, and workflows, reducing manual boilerplate and ensuring consistent task execution.

Core Features & Use Cases

  • Task structure and anatomy: default task file naming, targets, parameters, and lifecycle hooks to model complex build and deployment workflows.
  • Lifecycle events: preTask, postTask, onError, and aroundTask support for robust orchestration and error handling.
  • Interactive and automation capabilities: progress bars, interactive jobs, watching files, executing commands, and shell integration.
  • Dependency-based workflows: defining and composing task targets to run dependent steps in sequence.

Quick Start

Create a default task file named task.cfc in your project, then run task run to execute the default target.

Frequently Asked Questions about commandbox-task-runners

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate CFML build workflows using CommandBox task runners?

Automate CFML build workflows by defining a task.cfc file with targets, parameters, and lifecycle hooks, then execute them in CommandBox to orchestrate structured build and deployment sequences automatically.

What are CommandBox task lifecycle hooks and how do they work?

CommandBox task lifecycle hooks are preTask, postTask, onError, and aroundTask events that trigger automatically around target execution, allowing you to inject setup, teardown, and error handling logic into your task workflows.

Can I run interdependent task targets sequentially in CommandBox?

Yes, you can define interdependent task targets in CommandBox by specifying dependencies, allowing the task runner to automatically compose and execute dependent build steps in the correct sequence.

Does CommandBox task automation support file watching and async threading?

Yes, CommandBox task automation supports file watching to trigger tasks on changes, async threading for concurrent execution, interactive progress bars, and shell integration for comprehensive workflow orchestration.

How do I pass named parameters to a CommandBox task?

Pass named parameters to CommandBox tasks by defining them in your task.cfc target method signatures, then supply the values during the task run command to customize execution without modifying the task structure.

What is the best way to handle errors in CFML task automation scripts?

Handle errors in CFML task automation by implementing the onError lifecycle hook in your task.cfc, which intercepts execution failures and allows you to define custom recovery, logging, or cleanup logic for your workflow.