# roemer/git-filter-repo architecture

> Architecture diagram of the GitHub repository roemer/git-filter-repo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roemer/git-filter-repo
- Repository: https://github.com/roemer/git-filter-repo

## Overview

This repository packages git-filter-repo as a Docker image. The main workflow is to mount a mirror clone at /repo, run a filtering or analysis command in the container, then use the resulting repository or report. The README also documents interactive shell access and optional local-user mapping. No source excerpts are available, so the graph shows only relationships explicitly described in the README; image internals are not inferred.

Main entry points: [`Dockerfile`](https://github.com/roemer/git-filter-repo/blob/master/Dockerfile) (Docker image)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_container["Container workflow"]
  node_mirror[("Mirror clone")]
  node_image["Docker image"]
  node_filter["git-filter-repo"]
  node_report["Analysis report"]
  node_cleaned[("Filtered repository")]
  node_shell["Interactive shell"]
end

node_user(("Repository user"))

node_user -->|"creates mirror"| node_mirror
node_user -->|"runs"| node_image
node_mirror -->|"mounts at /repo"| node_image
node_image -->|"runs commands"| node_filter
node_filter -->|"writes analysis"| node_report
node_filter -->|"rewrites history"| node_cleaned
node_user -->|"may attach"| node_shell
node_image -->|"starts bash"| node_shell

click node_image "https://github.com/roemer/git-filter-repo/blob/master/Dockerfile"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mirror,node_image,node_filter,node_report,node_cleaned,node_shell,node_user toneBlue
```

## Components

### Container workflow

- **Mirror clone**
- [Docker image](https://github.com/roemer/git-filter-repo/blob/master/Dockerfile): `Dockerfile`
- **git-filter-repo**
- **Analysis report**
- **Filtered repository**
- **Interactive shell**

### Other components

- **Repository user**

## Connections

- Repository user → Mirror clone: creates mirror (evidence: `README.md`)
- Repository user → Docker image: runs (evidence: `README.md`)
- Mirror clone → Docker image: mounts at /repo (evidence: `README.md`)
- Docker image → git-filter-repo: runs commands (evidence: `README.md`)
- git-filter-repo → Analysis report: writes analysis (evidence: `README.md`)
- git-filter-repo → Filtered repository: rewrites history (evidence: `README.md`)
- Repository user → Interactive shell: may attach (evidence: `README.md`)
- Docker image → Interactive shell: starts bash (evidence: `README.md`)
