Skip to main content

​
Centralized Multi-Repository Setup

Set up Simili Bot with a central control repository that processes issues across your entire organization. This is Pattern B, ideal for unified management.

​
Prerequisites

  1. Multiple GitHub repositories to manage.
  2. Qdrant API Key & URL.
  3. Gemini API Key.
  4. Elevated GitHub Permissions (PAT or GitHub App).

​
Setup steps

1

Create control repository

Create a new private repository (e.g., simili-bot-control) to host your master configuration and workflows.
2

Add master configuration

Create .github/simili.yaml in the control repo:
qdrant:
  url: "https://your-cluster.qdrant.io:6333"
  api_key: "${QDRANT_API_KEY}"
  collection: "org-issues"

defaults:
  cross_repo_search: true

repositories:
  - org: "your-org"
    repo: "backend"
  - org: "your-org"
    repo: "frontend"
3

Configure authentication

Pattern B requires elevated permissions. Add a Personal Access Token (PAT) with repo scope to your control repo secrets as GITHUB_TOKEN_PAT.
4

Organization secrets

Add QDRANT_URL, QDRANT_API_KEY, and GEMINI_API_KEY to your organization-level secrets and grant access to the control repository.
5

Create workflow

Create .github/workflows/simili-bot.yml in the control repo:
name: Simili Bot - Scheduled
on:
  schedule:
    - cron: '*/5 * * * *'
  workflow_dispatch:

jobs:
  process:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: similigh/simili-bot@v0.2.0
        with:
          command: "process"
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN_PAT }}
          QDRANT_URL: ${{ secrets.QDRANT_URL }}
          QDRANT_API_KEY: ${{ secrets.QDRANT_API_KEY }}
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
6

Submit & test

Go to the Actions tab in your control repo and manually trigger the workflow to ensure it can reach your target repositories.

​
Troubleshooting

Ensure your PAT has the repo scope and is correctly added as a secret in the control repository.
Verify that each target repository is correctly listed in the repositories section of your master simili.yaml.

​
Next Steps

Permission guide

Issue routing