/install git-federation-searcher
Git Federation Searcher
Search across multiple self-hosted Git instances in parallel.
Overview
This tool searches across various Git hosting platforms (not just GitHub/GitLab) including:
- Codeberg
- Gitea.com
- NotABug
- Gitdab
- Self-hosted instances
Features
- Multi-Instance Search: Search 5+ instances at once
- Auto-Discovery: Detects if instances are reachable
- Add Custom Instances: Add your own Gitea/GitLab instances
- Fallback to Web: Uses SearXNG if API search fails
- Type Detection: Auto-detects Gitea vs GitLab vs Forgejo
- Results by Stars: Sorted by popularity
Default Instances
| Instance | Type | URL |
|---|---|---|
| Codeberg | Gitea | https://codeberg.org |
| Gitea.com | Gitea | https://gitea.com |
| OpenDev | Gitea | https://opendev.org |
| NotABug | Gogs | https://notabug.org |
| Gitdab | Forgejo | https://gitdab.com |
Usage
Command Line
# Search all instances
python3 git_federation_searcher.py "whisper"
# List configured instances
python3 git_federation_searcher.py --list
# Add custom instance
python3 git_federation_searcher.py --add MyGitea https://git.example.com gitea
# Remove instance
python3 git_federation_searcher.py --remove MyGitea
Telegram Bot
/gitsearch whisper # Search all instances
/gitinstances # List all configured
/gitadd Name URL Type # Add custom instance
Supported Git Types
| Type | API | Notes |
|---|---|---|
| Gitea | ✅ Full | Best support |
| Forgejo | ✅ Full | Gitea fork, same API |
| GitLab | ✅ Full | Uses v4 API |
| Gogs | ✅ Partial | Basic search only |
Requirements
- Python 3.7+
- curl (for API calls)
- (Optional) SearXNG for web fallback
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install git-federation-searcher - After installation, invoke the skill by name or use
/git-federation-searcher - Provide required inputs per the skill's parameter spec and get structured output
What is Git Federation Searcher?
Search across multiple self-hosted Git instances including Gitea, Forgejo, GitLab, and Codeberg. Aggregates search results from Codeberg.org, Gitea.com, Open... It is an AI Agent Skill for Claude Code / OpenClaw, with 579 downloads so far.
How do I install Git Federation Searcher?
Run "/install git-federation-searcher" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Git Federation Searcher free?
Yes, Git Federation Searcher is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Git Federation Searcher support?
Git Federation Searcher is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Git Federation Searcher?
It is built and maintained by DJ_Swiss (@djswiss); the current version is v1.0.0.