What's new and changed in the IBM Software Hub command-line interface

The IBM Software Hub command-line interface (cpd-cli) updates can include new features and fixes. Releases are listed in reverse chronological order so that the latest release is at the beginning of the topic.

You can see a list of the new features for the platform and all of the services at What's new in IBM Software Hub.

IBM Software Hub Version 5.4.0

A new version of the IBM Software Hub CLI was released in June 2026 with IBM Software Hub 5.4.0.

Operand version: 5.4.0

This release includes the following changes:

New features
This release of the IBM Software Hub CLI includes the following features:
Track job execution across your orchestration pipelines

You can now monitor all jobs in IBM Orchestration Pipelines by using the cpd-cli pipeline run list command. Retrieve job runs for an entire pipeline by specifying the pipeline ID, or narrow your search to a specific job by specifying the job ID. Filter results by pipeline run name, space, project, or job run state to quickly find the information you need.

For more information on managing IBM Orchestration Pipelines, see the cpd-cli pipeline run list command reference.

Stop diagnostic data collection jobs on demand

You can now cancel a running diagnostic data collection job for IBM Software Hub services by using the cpd-cli diag cancel-job command and specifying the job ID. Use this capability to stop data collection when needed, such as when a job is no longer required or if the job is stuck.

For more information on diagnostic data collection , see the cpd-cli diag command reference.

Verify Model Gateway service health

You can now check whether the Model Gateway service is functioning correctly by running the cpd-cli health service-functionality command with model_gateway as the service value. This health check helps you to quickly identify and troubleshoot any issues with the Model Gateway service.

For more information on running health checks, see the cpd-cli health service-functionality command reference.

Updates
The following updates were introduced in this release:
Verify IBM watsonx Assistant(Assistant Builder) functionality in IBM watsonx™ Orchestrate

You can now validate the complete watsonx Assistant Builder flow when you run the cpd-cli health service-functionality for watsonx Orchestrate. The service-functionality check now includes the Assistant Builder capability.

Issues fixed in this release
The following issues were fixed in this release:
The cpd-cli health service-functionality check for select services fails due to deprecated runtime

Issue: The cpd-cli health service-functionality check for the following services fails consistently due to the usage of the deprecated Runtime 24.1 on Python 3.11:

  • Watson Machine Learning-the deployment flow fails.
  • Watson Studio-the notebook execution flow fails.
  • RStudio® Server Runtimes-the execution through job flow fails.

Resolution: With the cpd-cli health service-functionality command updated to use Runtime 25.1 on Python 3.12, the service-functionality check runs successfully.

The cpd-cli health service-functionality check for IBM Knowledge Catalog services times out

Issue: The cpd-cli health service-functionality check for the following services times out intermittently on the Confirm enrichment job completed step:

  • IBM Knowledge Catalog
  • IBM Knowledge Catalog Premium
  • IBM Knowledge Catalog Standard

Resolution: With the retry attempt count increased for 20 to 30, the cpd-cli health service-functionality check does not time out.

The cpd-cli health service-functionality check for IBM watsonx.data™ fails
Issue: The cpd-cli health service-functionality check for IBM watsonx.data fails on the Presto engine validation flow. The issue occurs as the v3 endpoint fails to retrieve buckets associated with the existing catalog:
{
"description": "Get bucket from catalog",
"statusCode": 200,
"httpStatus": "200 OK",
"httpMethod": "GET",
"httpRequestURI": "/lakehouse/api/v3/catalogs/iceberg_data",
"messageCode": "success",
"responseTimeMS": 262.187,
"message": "Catalog: %s : No Associated Buckets Found",
"success": false,
"requestTimestamp": "2026/02/02 10:55:25",
"extendedSuccessStatus": ""
}

Resolution: With the get catalog API version updated to v3, the cpd-cli health service-functionality check for watsonx.data does not fail.

Customer-reported issues fixed in this release
For a list of customer-reported issues that were fixed in this release, see the Fix List for IBM Cloud Pak for Data on the IBM Support website.