Having Trouble with Pieces CLI?
If the Pieces CLI isn't working as expected, follow these steps:
Update the Package Version(s)
Confirm you’re using the latest version of the Pieces CLI using the PIP or Conda package manager:
-
Opening a terminal on your device depends on your platform: Open your OS's search bar and enter
terminalfor macOS/Linux orCMDfor Windows. Open the recommendation. -
In the new terminal, type:
pip install pieces-cli -Uto update the Pieces CLI with Python’s PIP package manager.
An outdated version of PiecesOS might be causing the problems. Be sure to update it, too. When you start PiecesOS, it will prompt you to update.
If not, you can reinstall it to fix any remaining issues.
Restart your System After Updates
If you've recently installed or updated PiecesOS or the Pieces CLI, restart your system. This can help apply any system variables that may have been set up during installation.
Contact the Pieces support team if the issue persists.
Pieces-Specific Fixes
Make sure to check the health and status of PiecesOS. Review the items below if you are having problems with Pieces Drive or Pieces Copilot within the Pieces CLI.
Check PiecesOS Status
Check to make sure PiecesOS is running.
PiecesOS must be running for the Pieces CLI to work.
Refreshing Copilot Chats
You may need to restart or refresh the Pieces Copilot chat, especially if you’re using a cloud LLM and disconnect from WiFi.
These scenarios can occasionally cause the LLM to ‘hang’—to appear as if generating a response but eventually timing out, entering an infinite response loop, or experiencing other issues.
To do this, exit the current chat by pressing ⌘+c (macOS) or ctrl+c (Windows/Linux) to force stop the active chat. Then you can re-enter the ask “query” command.