latestOpenAPI 3.0.2raw.githubusercontent.com2026-08-173476143.5 KB

11bdb74527de

catalog

Find packages that provide a command

Reverse lookup: which package(s) provide the given command name.

Required Query Parameters:

system: The system architecture to search for (e.g., x86_64-linux)
name: The command name to look up (e.g., readelf, rg, gcc-13)

Returns:

ByCommandResult: Providers of the command and total count

Note: first pass returns a hardcoded mock so the OpenAPI contract can freeze before the command_index table lands. No database query yet.

get/api/v1/catalog/by-command

Query parameters

system'aarch64-darwin' | 'aarch64-linux' | 'x86_64-darwin' | 'x86_64-linux' | 'invalid' required

namestring required

Response

Packages that provide the given command

command_namestring required

total_countinteger required

listing_knownboolean required

Example response

{
  "command_name": "readelf",
  "listing_known": true,
  "providers": [
    {
      "attr_path": "binutils",
      "exact_name_match": false,
      "pname": "binutils",
      "system": "x86_64-linux"
    }
  ],
  "total_count": 1
}