Loading Ad-hoc Modules

Last updated 4 months ago

If you have a module installed to a folder that you wish to load into the CLI and use on-the-fly during a task runner, you can do so like this:

loadModule( 'build/modules/myUtils' );

That code will load the myUtils module right there into the core CLI. Note, the module needs to be compatible with CommandBox. All models, interceptors, or commands inside the module will instantly be available in the CLI.

This means your task runners can rely on other functionality in the form of modules which are easily distributed and shared. While you could manually install the module globally into the CLI, this method is more flexible and ad-hoc as the module is just temporarily loaded.


  • Modules aren't unloaded for you. You can do so via ModuleService.unload( 'myUtils' ) if you like.

  • If a module of that name is already loaded, nothing happens. That means if you modify the module, you'll need to reload the shell to pick up those changes.

  • The path to the module can be absolute, but if relative, it will be resolved relative to the task runner CFC, not the current working directory of the shell.