reposwarm

Open-source multi-repo architecture discovery for AI coding agents. Analyze repositories, generate standardized .arch.md files, and keep them in a central resul

What is reposwarm?

Open-source multi-repo architecture discovery for AI coding agents. Analyze repositories, generate standardized .arch.md files, and keep them in a central results hub for agent context, onboarding and architecture reviews. GitHub, GitLab, CodeCommit, Azure DevOps and Bitbucket. Apache-2.0.

Overview of reposwarm

What it is

RepoSwarm is an open-source tool that analyzes repositories and generates standardized .arch.md architecture files. It commits the results to a shared hub repository that AI coding agents can read as context. The tool supports GitHub, GitLab, AWS CodeCommit, Azure DevOps, and Bitbucket as git providers. It uses Anthropic API, Amazon Bedrock, or a LiteLLM proxy as model backends. RepoSwarm checks repository commits, branches, and prompt versions to decide when to re-analyze. It caches prompt results in DynamoDB or local files. The tool runs with Temporal workflows and requires Docker, Docker Compose, and Git for local setup. Generated findings need human review.

Key features

  • AI-powered analysis using Claude to understand codebases
  • Standardized output generating consistent .arch.md architecture files
  • Incremental updates based on repository commits, branches, and prompt versions
  • Smart caching via DynamoDB or file-based caching to avoid redundant work
  • Type-aware prompts for backend, frontend, mobile, infra, and libraries
  • Results hub that commits all architecture docs to a centralized repository
  • Multi-provider support for Anthropic API, Amazon Bedrock, or LiteLLM proxy
  • Multi-git support for GitHub, GitLab, CodeCommit, Azure DevOps, and Bitbucket

Use cases

RepoSwarm is used to give AI coding agents context across multiple repositories by providing architecture documentation. It can also be used for onboarding new developers and for architecture reviews. The generated .arch.md files serve as a standardized reference for understanding codebases.

Getting started

Install the CLI and bootstrap everything with:bashcurl -fsSL https://raw.githubusercontent.com/reposwarm/reposwarm-cli/main/install.sh | shThen:bashreposwarm new --local # Bootstrap everything: Temporal, API, Worker, UIreposwarm doctor # Full health checkreposwarm repos add my-app --url https://github.com/org/my-appreposwarm investigate my-app # Run your first investigationreposwarm dashboard # Watch it workPrerequisites: Docker must be running, and Git must be installed.

License and pricing

RepoSwarm is licensed under Apache-2.0. It is open-source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/reposwarmreposwarm.svg)](https://yunodb.com/tools/reposwarmreposwarm?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/reposwarmreposwarm?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/reposwarmreposwarm.svg" alt="Featured on YunoDB" height="20"></a>