A unified search tool for discovering repositories across multiple self-hosted and federated Git instances like Gitea, GitLab, and Forgejo.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install git-federation-searcher
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install git-federation-searcher using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Git Federation Searcher?
The Git Federation Searcher is a specialized utility designed to bridge the gap between fragmented Git hosting platforms. While most tools focus exclusively on centralized hubs, this skill enables users to query the broader ecosystem of self-hosted and community-driven Git instances. By integrating this into your Openclaw Skills library, you can search across Codeberg, Gitea.com, OpenDev, and private instances simultaneously from a single interface.
This tool is essential for developers and researchers who need to find open-source projects or internal codebases that reside outside of GitHub. It supports various API protocols and provides a robust fallback mechanism to ensure you never miss a repository due to API limitations. Whether you are managing an enterprise network of GitLab servers or exploring the decentralized forge federation, this skill provides a high-performance gateway to all your code sources.
Git Federation Searcher Use Cases
- Locating open-source libraries hosted on privacy-focused platforms like Codeberg or NotABug.
- Searching for specific code patterns across multiple internal corporate GitLab and Gitea instances.
- Aggregating repository search results for security audits across the federated Git landscape.
- Discovering niche projects in the Forgejo and Gogs ecosystems that are not indexed by mainstream search engines.
How Git Federation Searcher Works
- The user initiates a search query via the command line or a Telegram bot interface.
- The skill identifies all active and configured Git instances from its registry.
- Parallel API requests are dispatched to each instance, utilizing specific Gitea, GitLab, or Forgejo endpoints.
- For instances with restricted APIs, the skill optionally utilizes SearXNG to scrape web-based results.
- The tool normalizes the metadata from different sources, including repository names, URLs, and star counts.
- Results are aggregated, sorted by popularity, and presented in a unified list for the user.
Git Federation Searcher Setup
To begin using this tool within your Openclaw Skills environment, ensure Python 3.7+ is installed along with curl for API interactions.
# Search all default instances for a specific keyword
python3 git_federation_searcher.py "query"
# List all currently configured Git instances
python3 git_federation_searcher.py --list
# Add a new private Gitea or GitLab instance
python3 git_federation_searcher.py --add Name URL Type
Git Federation Searcher Data Schema & Taxonomy
The skill manages instance configurations and result sets using the following structure:
| Attribute | Description |
|---|---|
| Instance Name | The unique label for the Git host (e.g., Codeberg) |
| Instance URL | The base URL used for API and web requests |
| Platform Type | The software running the instance (Gitea, GitLab, Forgejo, or Gogs) |
| Connectivity | Boolean status indicating if the instance is reachable |
| Metrics | Sorted data including star counts and fork frequency |
Git Federation Searcher Advanced Features
- Parallel execution of search queries across 5+ instances for minimal latency.
- Auto-discovery of instance types to automatically determine the correct API version (v4 for GitLab, etc.).
- Full Telegram Bot integration allowing for remote repository searches via /gitsearch commands.
- Custom instance management with support for private tokens and specialized API headers.
- Intelligent fallback to SearXNG for web-based search when native APIs are disabled or unavailable.
SKILL.md
Loading
Related Openclaw Skills
ClawdHub CLI
A powerful command-line interface for managing the discovery, installation, and publication of Openclaw Skills.
bioSkills Bioinformatics Suite
A massive meta-skill collection providing 425 specialized bioinformatics capabilities for AI agents across 62 distinct research categories.
Home Assistant Master
A professional-grade operations skill for Home Assistant OS focusing on diagnostics, safety-first automation design, and system maintenance.
OpenClaw Bootstrap
A comprehensive one-command initialization tool for setting up a standardized OpenClaw workspace with built-in self-evolution capabilities.
X-Reader
A versatile Python tool for reading X (Twitter) posts using either public Nitter mirrors or RapidAPI for detailed data extraction.
Inner Life Chronicle
A sophisticated journaling skill for AI agents that converts daily interactions into structured self-reflections and emotional state updates.
Featured*
