Skip to main content
Lists Kosli repos matching the given filters. Kosli records a repo when an attestation or trail references it. Use the returned id values with the kosli_repo_tags resource to tag repos. To fetch a single repo, use the kosli_repo data source.
Data sources are read at plan time. A repo that Kosli first records later in the same pipeline is missing from repos until the next plan. No match returns an empty list, not an error.

Example usage

Schema

Optional

  • name (String) Return only repos with exactly this name, for example acme/platform/api. Conflicts with search.
  • namespace (String) Return only repos nested anywhere under this /-separated namespace, for example acme/platform.
  • search (String) Return only repos whose name contains this string (case-insensitive). Conflicts with name.
  • tag_filter (Block List) Return only repos with a matching tag. Repos must match every tag_filter block. See the nested schema below.
  • vcs_instance (String) Return only repos on this VCS host, for example gitlab.company.com.
  • vcs_provider (String) Return only repos hosted by this VCS provider, for example github, gitlab, bitbucket or azure-devops.

Read-only

  • repos (Attributes List) The matching repos, sorted by name and then by id. Empty when no repo matches. See the nested schema below.

Nested schema for tag_filter

Required:
  • key (String) Tag key the repo must have.
Optional:
  • values (List of String) Values the tag may have; a repo matches if its tag has any of them. Omit to match the key with any value.

Nested schema for repos

Read-only:
  • id (String) Internal Kosli ID of the repo. Use it as repo_id on kosli_repo_tags.
  • name (String) Full name of the repo, including its namespace. Names can repeat across VCS providers.
  • tags (Map of String) Key-value pairs tagging the repo.
  • url (String) URL of the repo.
  • vcs_instance (String) VCS host of the repo. Null when Kosli could not determine it.
  • vcs_provider (String) VCS provider of the repo. Null when Kosli could not determine it.
Last modified on November 16, 2026