[Enhancement] Allow for selection of multiple Git repositories

[neubig]

What problem or use case are you trying to solve?

Currently OpenHands only allows you to select one repository. However, in many cases multiple repositories are needed to solve a problem.

Describe the UX or technical implementation you have in mind

We can allow for selection of multiple repos in the frontend.

If you find this feature request or enhancement useful, make sure to add a 👍 to the issue

[enyst]

This a great issue, thank you.

I'd note though, this is not only FE if we want the same behavior regarding microagents, for every one of the repos, which I assume is what the user will expect. The selected repo is the "hook" for our microagents implementation. For example, we'd probably need to figure out how to inform the agent of repo.md files per repo. Similarly, we may want to figure out if / what behavior we want for knowledge microagents from the other repos.

The simpler alternative would be to declare a repo "primary", and do it only there. I do feel this may confuse people though, and I'm not sure in what order to the repos show up (will the first be first, so that people could at least remember?) or may need more FE indicators.

[github-actions[bot]]

This issue is stale because it has been open for 30 days with no activity. Remove stale label or comment or this will be closed in 7 days.

[tremblerz]

Most large scale projects are running under different folders and most companies do not have a mono-repo structure in place. So it will be very useful if we can bring an option for the agents to operate over multiple repos.

[erkinalp]

@openhands-agent

[jpelletier1]

There's an interesting Slack community thread discussing multi-repo pain points here: https://openhands-ai.slack.com/archives/C06R25BT5B2/p1756854584248079?thread_ts=1756851806.002119&cid=C06R25BT5B2

[jpelletier1]

I've been researching a bit about how users of Claude Code do this. I discovered this thread. Basically, there's a parent repo.md (or agents.md) that explains how the repos are related.

@enyst brings up a good point:

For example, we'd probably need to figure out how to inform the agent of repo.md files per repo. Similarly, we may want to figure out if / what behavior we want for knowledge microagents from the other repos.

Besides for allowing multiple repos to be selected, do we want OpenHands to try and figure out the relationship between the repos automatically?

[jpelletier1]

Some initial designs