Distributed Multi-Repository Setup

Setup Simili Bot across multiple repositories with team autonomy (Pattern C)

Distributed Multi-Repository Setup

Set up Simili Bot across multiple repositories with each team managing their own configuration while sharing a unified organization knowledge base. This is Pattern C.

Prerequisites

1. Multiple GitHub repositories to manage.
2. Qdrant API Key & URL.
3. Gemini API Key.
4. Organization-level GitHub secrets configured.

---

Setup steps

1. Base configuration (optional)

   Create a shared configuration repository (e.g., simili-config) with a base-config.yaml to store common settings like Qdrant URL and collection.

   qdrant:
     url: "https://your-cluster.qdrant.io:6333"
     collection: "org-issues"
   defaults:
     cross_repo_search: true
   
2. Organization-level secrets

   Add ORG_QDRANT_URL, ORG_QDRANT_API_KEY, and ORG_GEMINI_API_KEY to your organization-level secrets so all repos can access the same knowledge base securely.

3. Configure repositories

   In each repository, create .github/simili.yaml extending the shared base:

   extends: "https://raw.githubusercontent.com/your-org/simili-config/main/base-config.yaml"
   repositories:
     - org: "your-org"
       repo: "backend"
       description: "REST APIs for the backend service"
   
4. Create workflows

   In each repository, create .github/workflows/simili-bot.yml using the organization secrets:

   steps:
     - uses: similigh/simili-bot@v0.2.0
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         QDRANT_URL: ${{ secrets.ORG_QDRANT_URL }}
         QDRANT_API_KEY: ${{ secrets.ORG_QDRANT_API_KEY }}
         GEMINI_API_KEY: ${{ secrets.ORG_GEMINI_API_KEY }}
   
5. Test cross-repo search

   Open issues with similar topics across different repositories. Simili Bot should identify them as related, even across repository boundaries, providing a unified view of your organization’s issues.

---

Troubleshooting

Cross-repo search doesn't work

Ensure cross_repo_search: true is enabled in your base configuration and all repositories are indexing to exactly the same Qdrant collection.

Configuration not found

Verify the extends URL is correct and publicly accessible. Ensure you are using the Raw GitHub URL.

---

Next Steps

Modular configuration

Config inheritance