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.