/oss-alternatives

name: oss-alternatives
description: >
  Find actively maintained open source alternatives to any paid SaaS tool or commercial API.
  Use this skill whenever a user mentions wanting to replace, swap out, self-host, or find a
  free/open source version of a paid tool — including but not limited to tools like Datadog,
  Algolia, Twilio, Stripe, Auth0, Segment, Mixpanel, Intercom, PagerDuty, LaunchDarkly,
  SendGrid, Cloudinary, or any other commercial developer tool or API. Also trigger when the
  user says things like "is there an open source version of X", "I don't want to pay for X",
  "self-host alternative to X", or "what can I use instead of X for free".
  Runs parallel TinyFish agents to search GitHub and developer communities, then checks the
  real health of each candidate — last release, contributor count, stars, Docker support, and
  feature parity — and returns a ranked comparison with a plain English gain/loss summary.
compatibility:
  tools: [tinyfish]
metadata:
  author: tinyfish-community
  version: "1.0"
  tags: open-source saas alternatives github self-host developer-tools

OSS Alternatives Finder

Given any paid SaaS tool or commercial API, find and rank the best actively maintained open source alternatives by searching GitHub and developer communities in real time — then verify the health of each one and summarise exactly what a developer gains and loses by switching.

Pre-flight check

Before doing anything, verify TinyFish is installed and authenticated:

tinyfish --version
tinyfish auth status

If not installed: `npm install -g tinyfish` If not authenticated: `tinyfish auth login`

---

Step 1 — Understand the tool

Before searching, identify:

• **Tool name** — exactly as it is known (e.g. "Datadog", "Auth0", "Algolia")
• **Primary use case** — what problem it solves (e.g. "APM and log aggregation", "authentication", "search-as-a-service")
• **Key features the user cares about** — if not stated, infer from the tool's known capabilities

If the user hasn't told you what aspects matter most to them, ask one quick question: "Any features that are must-haves for your switch?" — then proceed.

---

Step 2 — Parallel discovery

Run all three discovery agents simultaneously using background processes. Each agent searches a different surface.

# Agent 1 — GitHub search for alternatives
tinyfish agent run \
  --url "https://github.com/search?q=open+source+alternative+{TOOL_NAME}&type=repositories&s=stars&o=desc" \
  "You are on a GitHub search results page for open source alternatives to {TOOL_NAME}.
   List the top 6 repository results. For each one extract:
   - full repo name (owner/repo)
   - star count
   - description
   - last commit date shown
   Do NOT click any repo links. Do NOT paginate. Return JSON array of objects with fields: repo, stars, description, last_commit." \
  --sync > /tmp/oss_github.json &

# Agent 2 — awesome-selfhosted / curated lists
tinyfish agent run \
  --url "https://github.com/awesome-selfhosted/awesome-selfhosted" \
  "You are on the awesome-selfhosted README page. Search this page for any tools related to '{TOOL_USE_CASE}' or '{TOOL_NAME}'.
   List up to 5 matching entries with their name, one-line description, and the GitHub URL if shown.
   Do NOT follow any links. Do NOT scroll more than twice. Return JSON array with fields: name, description, url." \
  --sync > /tmp/oss_awesome.json &

# Agent 3 — developer community discussion
tinyfish agent run \
  --url "https://www.reddit.com/search/?q=open+source+alternative+{TOOL_NAME}+self+host&sort=relevance&t=year" \
  "You are on Reddit search results for open source alternatives to {TOOL_NAME}.
   Read the titles and snippets of the top 8 posts. Extract any specific tool names mentioned as alternatives.
   Do NOT click any post links. Do NOT scroll. Return a JSON array of tool names mentioned: [{name, context}]." \
  --sync > /tmp/oss_reddit.json \
  --browser-profile stealth &

# Wait for all three to finish
wait

# Collect results
echo "=== GITHUB ===" && cat /tmp/oss_github.json
echo "=== AWESOME ===" && cat /tmp/oss_awesome.json
echo "=== COMMUNITY ===" && cat /tmp/oss_reddit.json

Replace `{TOOL_NAME}` with the actual tool name and `{TOOL_USE_CASE}` with its primary use case before running.

---

Step 3 — Consolidate candidates

From the three result sets, deduplicate and pick the **top 4–5 most promising candidates** based on:

• Appearing in multiple sources (strong signal)
• High star count on GitHub
• Recent activity mentioned
• Name recognition in the developer community

Discard anything that looks abandoned, niche, or unrelated.

---

Step 4 — Health check each candidate

For each candidate (run all in parallel):

# For each CANDIDATE run this pattern in parallel:
tinyfish agent run \
  --url "https://github.com/{CANDIDATE_REPO}" \
  "You are on the GitHub repository page for {CANDIDATE_REPO}.
   Extract ALL of the following in one pass — do not navigate away, do not click any tabs:
   - Star count (top of page)
   - Fork count
   - Number of contributors (shown in sidebar or Insights)
   - Last commit date (shown under the file list or in the latest release)
   - Latest release tag and date (if shown in right sidebar under Releases)
   - Whether a Dockerfile or docker-compose.yml is listed in the file tree (yes/no)
   - The number of open issues
   - License type
   - One sentence description from the repo About section
   Return as JSON: {stars, forks, contributors, last_commit, latest_release, latest_release_date, has_docker, open_issues, license, description}" \
  --sync > /tmp/oss_health_{CANDIDATE_SAFE_NAME}.json &

Run one instance of this per candidate, all backgrounded with `&`, then `wait`.

---

Step 5 — Feature parity check

For the top 2–3 candidates only, run one quick agent per candidate to check feature parity against the original tool:

tinyfish agent run \
  --url "https://github.com/{CANDIDATE