Skip to content

list_repos

Discover candidate repos available for a Polygraph session.

Returns the initiator repo and all organization repos with their descriptions and dependency-graph relationships (distance, direction, path). Use before start_session to understand which repos are available and optionally select a subset via selectedRepoIds. Supports filtering on connectedTo, published/consumed packages, published/consumed APIs, and name; results are capped at 50 by default - narrow the filter or pass force: true to bypass.

NameTypeRequiredDescription
connectedTostringnoRepository ID, name, or full name (e.g. "nrwl/ocean"). Match repos that share a dependency-graph edge with this repo. Matching is case-insensitive and exact - no substrings or globs.
publishedPackagesarraynoFuzzy-match repos that publish any of these packages (OR within field).
consumedPackagesarraynoFuzzy-match repos that consume any of these packages (OR within field).
publishedApisarraynoFuzzy-match repos that publish any of these APIs (OR within field).
consumedApisarraynoFuzzy-match repos that consume any of these APIs (OR within field).
nameFilterarraynoCase-insensitive substring or glob (*?[]{}) match on repo name or repositoryFullName. Multiple values are OR-combined.
forcebooleannoBypass the 50-repo cap. By default, results above the cap are suppressed; set true to return them anyway. Defaults to false.