OpenHands icon indicating copy to clipboard operation
OpenHands copied to clipboard

[Bug] Openhands `.openhands` org-level repo naming convention unsupported in GitLab / Self-Hosted GitLab.

Open wolfspyre opened this issue 6 months ago • 0 comments

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.

wolfspyre avatar Jun 17 '25 12:06 wolfspyre