🤝 Adjacent — Related Repositories Recommender

Adjacent is a GitHub Action that discovers and inserts a list of related repositories into your README based on shared GitHub topics.

Perfect for discovery, organization, and letting your users explore similar tools you’ve built.

---

🚀 Features

• 🔎 Finds related repositories by topic similarity
• 🧠 Ranks and inserts up to 5 adjacent repos into your README.md
• 🔄 Runs on a schedule or manual trigger
• 💬 Ideal for portfolios, developer tools, and curated ecosystems

---

📦 Usage

Here's a repository that uses this GitHub Action: https://github.com/notnews/fox_news_transcripts/

1. Add to your workflow

Save the following to .github/workflows/adjacent.yml:

name: Find Adjacent Repositories

on:
  schedule:
    - cron: '0 5 * * 0'   # Every Sunday at 5am UTC
  workflow_dispatch:

jobs:
  recommend-repos:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Adjacent Repositories Recommender
        uses: gojiplus/[email protected]
        with:
          token: ${{ secrets.GITHUB_TOKEN }}  # ✅ Pass the required token

      - name: Commit and push changes
        run: |
          git config --global user.name "github-actions"
          git config --global user.email "[email protected]"
          git add README.md
          git commit -m "Update adjacent repositories [automated]" || echo "No changes to commit"
          git push

🔗 Adjacent Repositories

• gojiplus/reporoulette — Sample Random GitHub Repositories

✨ Powered by Adjacent 🚀