Settings and Models
Learn how to configure the Pieces CLI—changing both LLMs and the code editor.
Supported LLMs
We continually update and configure our plugins and extensions to ensure compatibility with the latest large language models (LLMs).
The Pieces CLI currently supports 26 cloud-based models.
Supported LLMs | Supported LLMs |
|---|---|
Gemini-2.5 Flash Preview | GPT-4o Mini |
o4 Mini | Gemini-1.5 Pro |
o3 | Gemini-1.5 Flash |
GPT-4.1 | GPT-4o |
Gemini-2.0 Flash Lite | Claude 3 Haiku |
Gemini-2.5 Pro Experimental | Claude 3 Sonnet |
Gemini-2.5 Pro Preview | Claude 3 Opus |
Claude 3.7 Sonnet | GPT-4 Turbo |
o3 Mini | (Gemini) |
o1 | GPT-3.5-turbo |
Gemini-2.0 Flash Experimental | GPT-4 |
Claude 3.5 Sonnet | Codey (PaLM2) |
Claude 3.5 Haiku | (PaLM2) |
Read documentation on how to switch your Pieces Copilot Runtime (LLM) utilized by the Pieces CLI.
Settings Overview
Below is a breakdown of each adjustable setting (preferences, behaviors, views, etc.) you can find in the Pieces CLI, broken down by section
List Applications
To see every application you’ve registered, run list apps. This prints a table of app names and IDs so you can verify which integrations are available.
List Models
Use list models to display all AI models you’ve configured for the ask command. The output shows each model’s name and index, and which is currently active.
View Configuration
Run config to print your current IDE selection for code editing.
Edit Configuration
Execute config --editor <editorName> to open your config file in the editor of your choice. Simply adjust values (for example, change timeout: 10 to timeout: 20) and save—your changes take effect immediately.
Login
Authenticate with your Pieces Cloud account by running login. You’ll be prompted for credentials in a web browser; once you’re logged in, you can sync materials and access private resources in your Pieces Drive.
Logout
Use logout to clear your saved credentials and end your session. This is useful when switching accounts or working on a shared machine.
Contribute
Kick off a contribution workflow with contribute. You’ll be guided through describing your changes, and a pull-request template will open in your browser so you can submit improvements to the CLI.
Install PiecesOS
Run install to download and set up the PiecesOS, which provides background services, like Pieces Drive, and a graphical dashboard for non-CLI related tasks.
Open PiecesOS
Use open to launch the desktop app or helper Applet. If it isn’t already running, this command starts the service and brings up the GUI.
For additional support resources, check out our troubleshooting guide.