# kubernetes/git-sync

A sidecar app which clones a git repo and keeps it in sync with the upstream.

Repository: https://github.com/kubernetes/git-sync
Canonical: https://ross.abutalabs.com/products/git-sync
Language: Shell
License: Apache-2.0
License Family: permissive
Last push: 2026-07-28T01:47:59+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 94, release rhythm 81, longevity 100
- inputs: {"age_days": 3665, "days_push": 37, "days_rel": 48, "gap_med": 72, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2726, forks 469 (observed 2026-08-28T04:07:15.861789+00:00)

## What it is
git-sync is a command-line tool that clones a git repository into a local directory and periodically keeps it in sync with the upstream remote. It is designed to run as a sidecar container in Kubernetes, publishing each sync atomically via a symlink and optionally triggering webhooks or commands.

## Use cases
- keep config files in a kubernetes pod synced from a git repo
- run a sidecar container that pulls a git repo periodically
- sync static site content from git to a web server
- pull a specific branch, tag, or commit hash from git on an interval
- trigger a webhook or command after a git sync completes
- serve application files from a git repository without CI/CD

## When to choose
- you need files from a git repo continuously synced into a container or local directory
- you want atomic updates so consumers never see partial checkouts
- you run Kubernetes and want a simple sidecar for git-based config or content delivery

## When to avoid
- you need bidirectional git workflows like committing and pushing changes
- you need full CI/CD pipelines rather than simple file syncing
- your data source is not a git repository

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, deployment, workflow-automation, webhook
- domain: developer-tools
- platform: cli, cross-platform
- tags: git, sidecar, sync, kubernetes-sidecar, atomic-updates, devops, containers, automation, linux, docker, kubernetes

## Member repositories
- kubernetes/git-sync (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:15.861789+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:14:45.087333+00:00, confidence not recorded.
  - readme: https://github.com/kubernetes/git-sync (fetched 2026-08-28T04:07:15.861789+00:00, sha c56763157994)
- Data as of 2026-08-30T08:39:29.467469+00:00.