Local multi-agent system built with the A2A protocol to inspect GitHub repositories, classify their maintenance state, create cleanup plans and prepare reviewable branch updates for repository presentation.
The project is focused on improving a personal GitHub portfolio without changing default branches automatically. Generated changes are prepared on feature branches for human review.
- Scans real GitHub repositories through the GitHub API.
- Collects repository evidence from README files, manifests and project trees.
- Classifies repositories by status and project type.
- Builds prioritized cleanup actions.
- Generates final README and metadata updates.
- Applies updates to local feature branches.
- Pushes review branches only when explicitly enabled.
It does not merge pull requests, archive repositories or modify default branches automatically.
The implementation lives in agents/.
- Agent README: setup, configuration and usage.
- Architecture: system design and safety model.
- Implementation Guide: code structure and rebuild notes.
python -m venv .\agents\.venv
.\agents\.venv\Scripts\python.exe -m pip install -r .\agents\requirements.txt
Copy-Item .\agents\.env.example .\agents\.envEdit agents\.env with your GitHub and optional Bedrock credentials, then run:
.\agents\.venv\Scripts\python.exe -m unittest discover -s agents\tests
.\agents\scripts\run_all.ps1
.\agents\.venv\Scripts\python.exe .\agents\clients\cleanup_pipeline.pyMIT.