| name | scan-services |
| description | Discover new self-hosted services to add to server-compose. Scans curated sources (awesome-selfhosted, optionally r/selfhosted) for candidates, filters against what's already tracked, and optionally scaffolds a new service entry (directory + docker-compose.yml + services.yaml row). Use when the user asks to "find new services", "scan for new apps", "suggest self-hosted tools", "what should I add to server-compose", or runs /scan-services. |
scan-services
Discover self-hosted services worth adding to this repo. Curation is the job — Claude picks a small shortlist that fits the user's existing taste; the shell helper does the mechanical work.
Inputs
Accept optional argument hints from the user:
- Category focus — e.g. "networking", "monitoring", "finance". Bias the scan toward that category.
- Source — default is awesome-selfhosted; user may ask to scan r/selfhosted or GitHub trending.
- Count — how many candidates to surface (default: 5).
If the user gives no hints, scan broadly and return a balanced shortlist across categories they already use.
Workflow
1. Enumerate what's already tracked
./scan-services.sh list
./scan-services.sh categories
Read these into memory so you can filter candidates and understand the user's taste (what kinds of services they pick, what categories dominate).
2. Fetch candidate sources
Use WebFetch. Default source:
https://raw.githubusercontent.com/awesome-selfhosted/awesome-selfhosted/master/README.md
Optional secondary sources (use only if the user asks or the primary yields nothing useful):
https://www.reddit.com/r/selfhosted/top.json?t=month&limit=50 — top posts from the last month (look for "I made X" / "X just released" patterns).
