testbox-runners

Coordinate TestBox test execution across CLI, HTML, and programmatic runners.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating TestBox test execution across multiple runners (CommandBox CLI, BoxLang CLI, and HTML web runner) and programmatic interfaces can be error-prone and time-consuming.

Core Features & Use Cases

  • Unified runner support: CommandBox CLI (testbox run), BoxLang CLI (./testbox/run), HTML web runner, and programmatic usage (run/runRaw/runRemote).
  • Streaming and watch modes for real-time feedback and automated re-runs on changes.
  • Centralized configuration for tests in box.json and CI/CD pipelines, enabling reproducible test environments.

Quick Start

Configure and run TestBox tests using your preferred runner (CLI, BoxLang, or HTML) with streaming output and watch mode.

Frequently Asked Questions about testbox-runners

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

FAQPage Schema
How do I run TestBox tests across multiple runners from the CLI?▼

You can run TestBox tests across multiple runners by coordinating execution through CommandBox CLI, BoxLang CLI, and the HTML web runner using centralized box.json configuration for unified test management.

Can I stream TestBox output in real time during test execution?▼

Yes, streaming mode provides real-time feedback during TestBox execution. It applies to CLI-based runtimes and programmatic interfaces, allowing you to monitor test progress as it happens.

How do I automate TestBox test re-runs when files change?▼

Watch mode automates TestBox test re-runs by detecting file changes and triggering subsequent executions. It works alongside streaming output for immediate feedback during development.

Does TestBox support reproducible test environments for CI/CD pipelines?▼

TestBox supports reproducible CI/CD workflows through centralized box.json configuration and standard CLI flags. This ensures consistent test execution environments across pipeline runs.

What programmatic interfaces are available for running TestBox tests?▼

Programmatic interfaces include run, runRaw, and runRemote methods for executing TestBox tests. These integrate with streaming and watch modes for flexible automated testing workflows.

Do I need a box.json file to configure TestBox test runners?▼

Yes, a box.json configuration file is required to coordinate TestBox test execution. It centralizes runner settings and enables reproducible environments across CLI and programmatic usage.