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 packages recorded in the local package database.

Usage

foton list [OPTIONS] [<PACKAGE>...]

Arguments

<PACKAGE>

Package names, optionally with an exact version as <package-name>@<version>.

If not specified, show all packages in the local package database.

Options

--format <FORMAT>

Select the output format.

  • Default: text
  • Possible values: text, jsonl

Global options

--exit-on-lock

Exit immediately if the package database is locked by another operation.

--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 packages recorded in the local package database:

foton list

Show packages as JSON Lines:

foton list --format jsonl

Output

list prints packages recorded in the local package database. In text output, each line contains a package name, version, installation state, and activation state:

example-font@1.2.3 (installed, active)

With --format jsonl, list writes one JSON object per listed package in JSON Lines format.

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 recorded states.