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.mdarchitecture 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.