Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

list

List installed packages.

Usage

foton list [OPTIONS]

Options

--show-incomplete

Include packages left by incomplete installs, uninstalls, or updates.

Without this option, only packages in the installed state are shown. With this option, leftover packages are shown with states such as incomplete-install and incomplete-uninstall.

--no-confirm

Skip interactive confirmation prompts.

--warnings-as-errors

Treat warnings as errors, causing the command to fail if any warning is emitted.

Examples

Show installed packages:

foton list

Show installed packages together with leftover packages from incomplete installs, uninstalls, or updates, and their states:

foton list --show-incomplete

Output

Without --show-incomplete, each line contains a package name and version:

example-font@1.2.3

With --show-incomplete, each line also includes the package state:

example-font@1.2.3 (installed)
another-font@0.1.0 (incomplete-install)

Notes

  • list reads the local package database and does not access package registries.
  • Use info when you want more than the package name, version, and state.