{"id":28148142,"url":"https://github.com/gojiplus/adjacent","last_synced_at":"2026-01-25T17:31:23.353Z","repository":{"id":284877257,"uuid":"956352945","full_name":"gojiplus/adjacent","owner":"gojiplus","description":"Add related repositories to your readme","archived":false,"fork":false,"pushed_at":"2025-12-21T04:43:01.000Z","size":51,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-23T00:27:28.432Z","etag":null,"topics":["github-tools","recommender","related-repos"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gojiplus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null}},"created_at":"2025-03-28T05:34:29.000Z","updated_at":"2025-12-21T04:43:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"ba549750-ec1b-4c5c-8e3b-9809cf71626c","html_url":"https://github.com/gojiplus/adjacent","commit_stats":null,"previous_names":["gojiplus/adjacent"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/gojiplus/adjacent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gojiplus%2Fadjacent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gojiplus%2Fadjacent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gojiplus%2Fadjacent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gojiplus%2Fadjacent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gojiplus","download_url":"https://codeload.github.com/gojiplus/adjacent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gojiplus%2Fadjacent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28755917,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T16:32:25.380Z","status":"ssl_error","status_checked_at":"2026-01-25T16:32:09.189Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-tools","recommender","related-repos"],"created_at":"2025-05-15T00:24:07.105Z","updated_at":"2026-01-25T17:31:23.347Z","avatar_url":"https://github.com/gojiplus.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤝 Adjacent — Related Repositories Recommender\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/gojiplus/adjacent)\n![GitHub Marketplace](https://img.shields.io/badge/GitHub%20Marketplace-adjacent)\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)\n[![Used By](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/gojiplus/adjacent/main/docs/adjacent.json)](https://github.com/search?q=gojiplus/adjacent+path%3A.github%2Fworkflows+language%3AYAML\u0026type=code)\n\n**Adjacent** is a GitHub Action that discovers and inserts a list of **related repositories** into your README based on shared GitHub topics and README content similarity.\n\nPerfect for discovery, organization, and letting your users explore similar tools you've built.\n\n---\n\n## 🚀 Features\n\n- 🔎 **Multiple similarity methods**: GitHub topics, README content, or combined approach\n- 🧠 **Smart ranking**: Configurable weighting between topics and content similarity\n- 🚫 **Repository exclusions**: Skip specific repositories you don't want to include\n- 📊 **Customizable output**: Set maximum number of repositories to display\n- 🔄 **Automated updates**: Runs on schedule or manual trigger\n- 💬 **Perfect for**: Portfolios, developer tools, and curated ecosystems\n\n---\n\n## 📦 Usage\n\nHere's a repository that uses this GitHub Action: https://github.com/notnews/fox_news_transcripts/\n\n### 1. **Add to your workflow**\n\nSave the following to `.github/workflows/adjacent.yml`:\n\n```yaml\nname: Find Adjacent Repositories\n\non:\n  schedule:\n    - cron: '0 5 * * 0'   # Every Sunday at 5am UTC\n  workflow_dispatch:\n\njobs:\n  recommend-repos:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout repository\n        uses: actions/checkout@v4\n\n      - name: Adjacent Repositories Recommender\n        uses: gojiplus/adjacent@v1.4\n        with:\n          token: ${{ secrets.GITHUB_TOKEN }}  # ✅ Required: GitHub token\n          similarity_method: 'combined'        # Optional: topics, readme, or combined\n          topic_weight: '0.6'                  # Optional: weight for topics (0-1)\n          exclude_repos: 'template,archived'   # Optional: comma-separated exclusions\n          max_repos: '5'                       # Optional: max repositories to show\n\n      - name: Commit and push changes\n        run: |\n          git config --global user.name \"github-actions\"\n          git config --global user.email \"actions@github.com\"\n          git add README.md\n          git commit -m \"Update adjacent repositories [automated]\" || echo \"No changes to commit\"\n          git push\n\n```\n\n## ⚙️ Configuration Options\n\n| Input | Description | Default | Example |\n|-------|-------------|---------|----------|\n| `token` | GitHub token for API access | **Required** | `${{ secrets.GITHUB_TOKEN }}` |\n| `repo` | Target repository | Current repo | `owner/repository` |\n| `similarity_method` | Method: `topics`, `readme`, or `combined` | `combined` | `topics` |\n| `topic_weight` | Weight for topics in combined method (0-1) | `0.6` | `0.8` |\n| `exclude_repos` | Comma-separated repository names to exclude | _(none)_ | `template,archived,old-project` |\n| `max_repos` | Maximum repositories to display | `5` | `3` |\n\n## 🔗 Adjacent Repositories\n\n- [gojiplus/reporoulette](https://github.com/gojiplus/reporoulette) — Sample Random GitHub Repositories\n\n✨ _Powered by [Adjacent](https://github.com/gojiplus/adjacent)_ 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgojiplus%2Fadjacent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgojiplus%2Fadjacent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgojiplus%2Fadjacent/lists"}