Troubleshooting
Fix missing commands, failed metadata loading and authentication issues.
BPCLI is not recognized
If bpcli is not recognized after installation, close and reopen the terminal first. Then run bpcli version again. If you used the standalone binary, confirm that its folder is included in PATH.
On Windows, check System Environment Variables and confirm that the folder containing bpcli.exe is listed in System PATH. On Linux or macOS, confirm that the export PATH=$PATH:/path/to/bpcli line points to the correct folder and is saved in the shell profile you actually use.
Version list fails
If a download or version list fails on the CLI page, refresh the page and try again. The page shows Failed to fetch CLI versions. Please try again later. when it cannot load version metadata.
Command requires authentication
Some Boilerplate commands need an authenticated user. Run an interactive login locally, or use token login for automation and CI environments.
bpcli login
bpcli login --token "$BPCLI_TOKEN" --jsonProject command gives unexpected results
Run project-aware commands from the project root, then check that the expected manifest and lockfile exist. If install, audit, deptree or why reports missing data, confirm the language and package manager with bpcli langs and bpcli packageManager, then rerun the command with explicit arguments where supported.