Getting Started

Prerequisites

Tool	Install
git	Pre-installed on macOS
docker	Docker Desktop or OrbStack
jq	brew install jq
gh	brew install gh then gh auth login
claude	claude.ai/code

Install

git clone https://github.com/hanfour/multi-repo-agent.git ~/multi-repo-agent
cd ~/multi-repo-agent && bash install.sh && source ~/.zshrc

Initialize workspace

mra init ~/workspace --git-org git@github.com:my-org

This clones repos listed in repos.json, scans docker-compose for service relationships, and detects dependencies.

Verify

mra doctor

First session

mra my-api --with-deps

Claude launches with my-api plus all its consumers/dependencies in context.

Sync & ship across repos

mra sync --safe          # fast-forward pull every repo
mra branch status        # which repos need attention
mra branch pr            # push branches + open PRs (deps first)
mra branch merge --wait-ci   # merge each PR once CI is green

See mra sync and mra branch for the full workflow.

Next steps

• Cross-repo development
• Branch-aware sync & PRs
• Code review
• Project Knowledge Base