[Bug] Openhands `.openhands` org-level repo naming convention unsupported in GitLab / Self-Hosted GitLab.
What problem or use case are you trying to solve?
The creation of Org-level microagent repos is neat! Currently the hardcoded naming convention precludes using them in GitLab.
Describe the UX or technical implementation you have in mind
According to DeepWiki This should be relatively simple to fix (giggle)
copypasta from some quick searching:
Based on the OpenHands codebase, there's a potential issue with the naming convention for organization-level microagent repositories in GitLab.
OpenHands expects organization-level microagents to be stored in a repository named
.openhands under your organization or user account.
microagents-org.mdx:11-12`
The system constructs the repository path as {domain}/{org_name}/.openhands and attempts to clone it when loading microagents.base.py:692
You're absolutely right that GitLab (and most Git hosting services) don't allow repository names that start with a period (.). This creates a conflict with OpenHands' expected naming convention.
Potential Workarounds / Current Implementation Details
The current OpenHands implementation specifically looks for a .openhands repository name in the code base.py:692-694
The microagents loading system expects to find a microagents directory within the .openhands repository base.py:721-724 , and the cloning process uses git authentication if available. base.py:707-712
Notes
This appears to be a genuine limitation in the current OpenHands implementation when used with GitLab. The codebase is designed around the .openhands naming convention and doesn't currently provide alternative naming patterns for different Git hosting services.
What do y'all think? is the issue that simple? I can file a PR with changes if there's nothing else to consider here.