Skip to main content

Interface: CliToolOptions

Defined in: packages/extension-api/src/extension-api.d.ts:4561

Options to create new CliTool instance and register it in podman desktop

Properties

displayName

displayName: string

Defined in: packages/extension-api/src/extension-api.d.ts:4563


images

images: ProviderImages

Defined in: packages/extension-api/src/extension-api.d.ts:4565


installationSource?

optional installationSource: CliToolInstallationSource

Defined in: packages/extension-api/src/extension-api.d.ts:4583

How the cli tool has been installed

  • external: it has been installed by the user externally from podman desktop. Its update process is disable.
  • extension: it has been installed by podman desktop extension. It can be updated

markdownDescription

markdownDescription: string

Defined in: packages/extension-api/src/extension-api.d.ts:4564


name

name: string

Defined in: packages/extension-api/src/extension-api.d.ts:4562


path?

optional path: string

Defined in: packages/extension-api/src/extension-api.d.ts:4576


version?

optional version: string

Defined in: packages/extension-api/src/extension-api.d.ts:4575

Within your extension, it is reccommended to implement your own functionality to check the current version number of the CLI tool. For example, parsing the information from the CLI tool's --version flag. Passing in path will also help to show where the CLI tool is expected to be installed. This is usually the ~/.local/share/containers/podman-desktop/extensions-storage directory. Note: The expected value should not include 'v'. Note: If the version and path are not defined (= the tool is not installed), the install logic should be implemented