Command Wheels Reload via CommandBox

[Alex1356250]

Hi everyone,

I’ve been having trouble using the wheels reload CLI command via CommandBox (v6.3.1) in my project (cfwheels v 2.5.1+32) for the past few weeks. It appears that for some reason, Box no longer recognized the correct root directory for executing this command (even if I was in the good one). The only solution I found was to restart the server each time...

This morning, I attempted to run an « install cfwheels-cli --force » command in Box, and all my issues were resolved. I’m curious to understand why this solution worked. Has there been any recent update?

Thanks,

Alexandre

[zainforbjs]

The original cfwheels-cli package was built for Wheels 2.x and the last compatible release for that line is cfwheels-cli@1.1.0. After that, the CLI was updated to support Wheels 3.0, and those changes aren’t fully compatible with 2.5 projects. That mismatch can lead to odd behavior like the CLI not correctly resolving the app root, even when you’re in the right directory.

When you ran install cfwheels-cli --force, CommandBox reinstalled the CLI and effectively reset things, which is why it suddenly started working again.

If you’re staying on Wheels 2.5, the safest setup is to explicitly install the last compatible version:

install cfwheels-cli@1.1.0

For Wheels 3.0, the CLI was moved forward under a new, actively maintained package called wheels-cli, which is what current projects should be using.

So there hasn’t necessarily been a breaking change in CommandBox itself—this is more about CLI version compatibility with the Wheels version you’re running.

[Alex1356250]

Thanks for your answer! I now have a better understanding of why I’m having trouble with my Wheels 2.5 projects but not with the 3.0 projects. I've juste tried install the command and it works perfectly!