内容摘录
🤖 RepoSwarm
<p align="center">
<img src="assets/banner-nodes.png" alt="RepoSwarm - Multi-Repo Architecture Discovery" width="100%">
</p>
<p align="center">
<strong>AI-powered multi-repo architecture discovery platform</strong>
</p>
<p align="center">
<a href="https://github.com/reposwarm/reposwarm/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=for-the-badge" alt="License"></a>
<a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.12+-3776AB.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.12+"></a>
<a href="https://www.youtube.com/watch?v=rOMf9xvpgtc"><img src="https://img.shields.io/badge/Demo-YouTube-red.svg?style=for-the-badge&logo=youtube" alt="YouTube Demo"></a>
</p>
<p align="center">
<a href="#quick-start">Quick Start</a> •
<a href="#what-is-reposwarm">What Is It</a> •
<a href="#how-it-works">How It Works</a> •
<a href="#ecosystem">Ecosystem</a> •
<a href="#contributing">Contributing</a>
</p>
**📦 Previously loki-bedlam/repo-swarm. Moved to the RepoSwarm organization. Old URLs redirect automatically.**
---
Quick Start
Install the CLI and bootstrap everything in one shot:
Then:
That's it. The CLI handles setup, configuration, investigation, diagnostics, and results — all from a single binary.
👉 **Full CLI docs:** **reposwarm-cli**
---
What is RepoSwarm?
RepoSwarm automatically analyzes your entire codebase portfolio and generates standardized architecture documentation. Point it at your GitHub repos (or CodeCommit, GitLab, Azure DevOps, Bitbucket) and get back clean, structured .arch.md files — perfect as AI agent context, onboarding docs, or architecture reviews.
<p align="center">
<img src="assets/banner-swarm.png" alt="RepoSwarm Agents" width="80%">
</p>
✨ Key Features
🔍 **AI-Powered Analysis** — Uses Claude to deeply understand codebases
📝 **Standardized Output** — Generates consistent .arch.md architecture files
🔄 **Incremental Updates** — Only re-analyzes repos with new commits
💾 **Smart Caching** — DynamoDB or file-based caching avoids redundant work
🎯 **Type-Aware Prompts** — Specialized analysis for backend, frontend, mobile, infra, and libraries
📦 **Results Hub** — All architecture docs committed to a centralized repository
🔌 **Multi-Provider** — Anthropic API, Amazon Bedrock, or LiteLLM proxy
🌐 **Multi-Git** — GitHub, GitLab, CodeCommit, Azure DevOps, Bitbucket
📋 See It In Action
Check out RepoSwarm's self-analysis — RepoSwarm investigating its own codebase!
🎬 **Architecture Overview (click to play)**
▶ Watch on YouTube
---
How It Works
<p align="center">
<img src="assets/architecture.png" alt="RepoSwarm Architecture" width="100%">
</p>
**Pipeline:** Cache check → Clone → Type detection → Structure analysis → Prompt selection → AI analysis → Store results → Cleanup
---
Common Workflows
Run an Investigation
Investigate All Repos in Parallel
Diagnose Issues
Search Across All Architecture Docs
👉 **Full command reference:** **reposwarm-cli README**
---
Configuration
LLM Provider
Git Provider
Adding Repositories
Or edit prompts/repos.json directly:
Analysis Prompt Types
| Type | Focus | Prompts |
|------|-------|---------|
| 🔧 **Backend** | APIs, databases, services | prompts/backend/ |
| 🎨 **Frontend** | Components, routing, state | prompts/frontend/ |
| 📱 **Mobile** | UI, device features, offline | prompts/mobile/ |
| 📚 **Libraries** | API surface, internals | prompts/libraries/ |
| ☁️ **Infrastructure** | Resources, deployments | prompts/infra-as-code/ |
| 🔗 **Shared** | Security, auth, monitoring | prompts/shared/ |
---
Ecosystem
| Project | Description | Install |
|---------|-------------|---------|
| ⌨️ **reposwarm-cli** | CLI — setup, investigate, diagnose, results | curl -fsSL .../install.sh \| sh |
| 🔌 **reposwarm-api** | REST API server for repos, workflows, prompts | Managed by CLI |
| 📊 **reposwarm-ui** | Next.js dashboard for browsing investigations | Managed by CLI |
| 🤖 **reposwarm** (this repo) | Core engine — Temporal workflows + analysis | Managed by CLI |
| 📋 **sample-results-hub** | Example output — generated .arch.md files | — |
---
Project Structure
---
Credits
RepoSwarm was born out of a hackathon at Verbit, built by:
Moshe
Idan
Roy
---
Contributing
Fork the repository
Create a feature branch
Make changes and add tests
Submit a pull request
---
License
This project is licensed under the Apache License 2.0.