Troubleshoot Coveo CLI issues

This is for:

Developer

This article helps you resolve common issues encountered when using the Coveo CLI.

ui:create:atomic requires a valid npx installation

Symptoms

  • Running coveo ui:create:atomic <project-name> fails with the following error message:

    Precondition Error - Invalid Bin installation: ui:create:atomic requires a valid npx installation to run.

  • You can also see:

    An unknown error happened while running npx.ps1 --version.
npx.ps1 : The term 'npx.ps1' is not recognized as the name of a cmdlet, function, script file, or operable program.

Cause

The installed version of npm is outdated and doesn’t include a valid npx binary. Versions of npm lower than 10.16.0 have been observed to cause this problem, even when Node.js is relatively up to date.

Solution

  1. Update npm globally to the latest supported version:

    npm install -g npm

  2. Verify that npm was updated successfully:

    npm -v