Skip to main content

List Command

burger-api list (alias: ls) shows all available hooks and plugins from the official ecosystem.

  • Fetches the latest list and displays names and descriptions in a table.
  • Use with burger-api add <name> to install hooks or plugins.
  • The catalog is cached locally (~/.burger-api/cache/, four hours) so repeat runs don't hit GitHub every time. If GitHub is unreachable, list falls back to the cached catalog with a warning instead of failing outright, as long as a cache already exists from a prior successful run.
  • --local reads the local checkout instead (no cache, no network). See Local mode.

Example:

burger-api list
burger-api list --local

See CLI Tool and Ecosystem.