Chapter 2. Installing the command-line assistant powered by RHEL Lightspeed


The command-line assistant powered by RHEL Lightspeed is an optional tool available through the official RHEL 9 repositories.

Before you can start using the command-line assistant powered by RHEL Lightspeed, you must install it through the official RHEL repositories. The command-line assistant is supported in the following architectures:

  • AMD and Intel 64-bit (x86_64)
  • ARM64 (aarch64)
  • IBM Z (s390x)
  • IBM POWER systems (ppc64)

To access the command-line assistant powered by RHEL Lightspeed, install it by using RHEL repositories. Do not use pip install command-line-assistant because Red Hat does not support this installation option.

Prerequisites

Procedure

  • On your RHEL system, run the following command:

    $ sudo dnf install command-line-assistant

Verification

  • Verify that the installation works by running the command-line assistant. For example:

    $ c "How to install python?"

    The output looks similar to the following example:

    +*+ Asking Red Hat Lightspeed
    
    To install python....
  • Disable the color output in the command-line assistant. For example:

    $ NO_COLOR=1 c “How to install python?"

You can install the command-line assistant powered by RHEL Lightspeed to your host registered to Red Hat Satellite. For that, update the command-line assistant endpoint, so that the RHEL system registered to Satellite can proxy command-line assistant by using the Satellite Server.

Prerequisites

  • Your system is registered with Red Hat Lightspeed for Red Hat Enterprise Linux.
  • You are using the command-line assistant on a host registered to a Satellite 6.17+ server or later versions.
  • The Satellite Server must be connected to the internet.
  • You have enabled the AppStream repository on the host to be able to install command-line assistant.

Procedure

  1. Install command-line assistant powered by RHEL Lightspeed on your registered host.

    $ sudo dnf install command-line-assistant
  2. Locate and open the /etc/xdg/command-line-assistant/config.toml file.
  3. In the config.toml file, replace the endpoint configuration option to point to your Satellite or Capsule hostname, for example:

    #The endpoint points to an API server.
    endpoint = "https://satellite.example.server.com/api/lightspeed/v1"
  4. Save the changes in the config.toml file.
  5. Restart command-line assistant daemon (clad) for the changes to be effective::

    $ sudo systemctl restart clad

Troubleshooting

If the command-line assistant cannot trust the Red Hat Satellite certificate authority (CA), it cannot establish a secure connection to the Satellite Server. As a result, the assistant does not function. To work around this problem:

  1. Copy the Satellite CA certificate to the system truststore:

    $ sudo cp /etc/rhsm/ca/katello* /etc/pki/ca-trust/source/anchors/
  2. Update the CA trust database:

    $ sudo update-ca-trust
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top