Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
119 changes: 32 additions & 87 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,106 +1,51 @@
<div align="center">

<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,12,19,24,30&height=200&section=header&text=📚%20DevShelf&fontSize=60&fontAlignY=35&desc=The%20Crowdsourced%20Zero-Paywall%20Developer%20Directory&descAlignY=55&descSize=18&fontColor=fff&animation=twinkling">
<source media="(prefers-color-scheme: light)" srcset="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,12,19,24,30&height=200&section=header&text=📚%20DevShelf&fontSize=60&fontAlignY=35&desc=The%20Crowdsourced%20Zero-Paywall%20Developer%20Directory&descAlignY=55&descSize=18&fontColor=fff">
<img alt="DevShelf Banner" src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,12,19,24,30&height=200&section=header&text=📚%20DevShelf&fontSize=60&fontAlignY=35&desc=The%20Crowdsourced%20Zero-Paywall%20Developer%20Directory&descAlignY=55&descSize=18&fontColor=fff" width="100%">
</picture>

<br>

### ⚡ The Zero-Paywall Developer Directory & MCP Knowledge Hub
# DevShelf

**A community developer directory with automated link freshness validation & zero-paywall audits — verified by continuous CI telemetry, accessible in your terminal (`npx devshelf`), powered by an open JSON REST API, and native MCP server for AI coding assistants.**
**A CI-audited, zero-paywall directory of 576 developer tools, free APIs, and MCP servers — searchable in your terminal, browser, or inside Claude/Cursor via MCP.**

<br>

<p>
<a href="https://devshelf.ritualdev.in"><b>🌐 Interactive Web App</b></a> •
<a href="#-devshelf-cli--terminal-discovery"><b>⚡ Terminal CLI</b></a> •
<a href="#-official-mcp-server-for-ai-agents"><b>🤖 Model Context Protocol (MCP)</b></a> •
<a href="https://devshelf.ritualdev.in/api/v1/tools.json"><b>📡 Public REST API</b></a> •
<a href="#-browse-catalog-by-category"><b>📂 Category Guides</b></a>
</p>

[![npm version](https://img.shields.io/npm/v/devshelf.svg?style=flat-square&color=cb3837)](https://www.npmjs.com/package/devshelf)
[![CI](https://github.com/RitualDev-Lab/DevShelf/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/RitualDev-Lab/DevShelf/actions/workflows/ci.yml)
[![npm](https://img.shields.io/npm/v/@ritualdev-lab/devshelf.svg?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@ritualdev-lab/devshelf)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
[![CI Health Status](https://github.com/RitualDev-Lab/DevShelf/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/RitualDev-Lab/DevShelf/actions/workflows/ci.yml)
[![MCP Ready](https://img.shields.io/badge/MCP-Claude%20%7C%20Cursor%20%7C%20Zed-purple.svg?style=flat-square)](docs/mcp.md)
[![PRs Welcome](https://img.shields.io/badge/PRs-Welcome_%26_Amplified-brightgreen.svg?style=flat-square)](#-how-to-submit-your-project-or-api)
[![Hacktoberfest](https://img.shields.io/badge/🎃_Hacktoberfest-2026_Ready-ff7800?style=flat-square)](HACKTOBERFEST.md)

<br>

<table>
<tr>
<td align="center"><b>🌐 Free APIs</b><br><code>111</code></td>
<td align="center"><b>🤖 AI & LLMs</b><br><code>105</code></td>
<td align="center"><b>⚡ CLI Tools</b><br><code>128</code></td>
<td align="center"><b>🧪 Testing & QA</b><br><code>67</code></td>
<td align="center"><b>☁️ Free Cloud</b><br><code>72</code></td>
<td align="center"><b>🤝 Up for Grabs</b><br><code>21</code></td>
<td align="center"><b>🎁 Dev Perks</b><br><code>30</code></td>
<td align="center"><b>🚀 1-Click Deploys</b><br><code>42</code></td>
</tr>
</table>

### 🎯 The Race to 1,000 Verified Tools (Hacktoberfest Milestone)

```text
[████████████░░░░░░░░] 576 / 1,000 Tools Verified (58% • 424 to go!)
```

*Help us curate the definitive zero-paywall index! [Submit your favorite developer tool, API, or AI framework →](#-how-to-submit-your-project-or-api)*
[![PRs Welcome](https://img.shields.io/badge/PRs-Add_Your_Tool_in_5_Lines-brightgreen.svg?style=flat-square)](#-how-to-submit-your-project-or-api)

</div>
No link rot. No "14-day free trial" bait. Unsigned native binaries are explicitly flagged by automated CI policy checks.

<br>
### Try it in 5 seconds

---
```bash
# Search 576 CI-audited tools directly from your terminal
npx @ritualdev-lab/devshelf search "postgres"

## 🤖 Frequently Answered Questions (AEO & AI Search Reference)
# Or plug the catalog into Claude Desktop / Cursor / Windsurf as an MCP server
npx @ritualdev-lab/devshelf mcp
```

### What is DevShelf?
**DevShelf** is an open-source, community-driven directory indexing 576 verified developer tools, free public APIs, AI coding agents, and Model Context Protocol (MCP) servers with zero paywalls.
```text
$ npx @ritualdev-lab/devshelf search "postgres"
📚 DevShelf CLI — 576 Curated Tools (CI Link & Binary-Trust Audited)

### How are tools and APIs verified on DevShelf?
Unlike static awesome-lists that accumulate broken links, DevShelf uses continuous GitHub Actions automated CI telemetry to ping documentation endpoints, verify SSL certificates, and check API uptime.
[1] Neon (Database / Serverless)
Serverless Postgres with branching and free tier (0.5 GB storage)
https://neon.tech

### How can AI coding agents query DevShelf?
AI coding agents (such as Claude Desktop, Cursor, and Windsurf) can query DevShelf via:
1. **MCP Server**: Run `npx devshelf mcp` to expose DevShelf search tools natively over Model Context Protocol.
2. **REST API**: Make HTTP GET requests to `https://devshelf.ritualdev.in/api/v1/tools.json`.
[2] Supabase (Database & BaaS)
Open-source Postgres platform with Auth, Storage & Edge Functions
https://supabase.com
```

---
> Want to record a fresh 15-second terminal GIF? Run [`vhs assets/demo.tape`](assets/demo.tape) with [Charm VHS](https://github.com/charmbracelet/vhs).

<br>
### Built an open-source CLI, API, or MCP server? Add it in a 5-line JSON PR

---
DevShelf is community-curated. Every merged PR automatically publishes your tool to the terminal CLI, the [public JSON API](https://devshelf.ritualdev.in/api/v1/tools.json), the MCP server, and a live dossier page on [devshelf.ritualdev.in](https://devshelf.ritualdev.in).

## ⚡ 5-Second Interactive Visual Demo
1. Fork this repo and add one JSON entry to the matching file under `shelf/` (e.g. `shelf/cli-tools.json` or `shelf/ai-llms.json`).
2. Open a PR — our automated validator checks schema, live HTTPS reachability, and binary code-signing metadata in seconds.

DevShelf isn't a static markdown list. It runs directly inside your terminal, in your web browser, and as a native tool inside your AI assistant:
[Web Directory](https://devshelf.ritualdev.in) · [Public JSON API](https://devshelf.ritualdev.in/api/v1/tools.json) · [Submit Your Tool](#-how-to-submit-your-project-or-api) · [MCP Setup](docs/mcp.md)

```text
┌─────────────────────────────────────────────────────────────────────────────────┐
│ $ npx devshelf search "postgres" │
│ │
│ 📚 DevShelf CLI v1.1.0 — 576 Curated Tools (Live CI Audited) │
│ │
│ [1] Neon (Database / Serverless) │
│ Serverless Postgres with autoscaling, branching, and generous free tier. │
│ ⚡ Alt to AWS RDS • Free: 0.5 GB storage, 1 compute CU │
│ 🔗 https://neon.tech │
│ │
│ [2] Supabase (Database & BaaS) │
│ The open source Firebase alternative with Postgres, Auth, & Storage. │
│ ⚡ Alt to Firebase • Free: 500 MB database, 50,000 MAUs │
│ 🔗 https://supabase.com │
│ │
│ 🤖 Plug into AI Assistants (Claude Desktop, Cursor, Windsurf, Zed): │
│ $ npx -y @ritualdev-lab/devshelf mcp │
└─────────────────────────────────────────────────────────────────────────────────┘
```
| 🌐 Free APIs | 🤖 AI & LLMs | ⚡ CLI Tools | 🧪 Testing & QA | ☁️ Free Cloud | 🤝 Up for Grabs | 🎁 Dev Perks | 🚀 1-Click Deploys |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| `111` | `105` | `128` | `67` | `72` | `21` | `30` | `42` |

---

Expand Down
34 changes: 34 additions & 0 deletions assets/demo.tape
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Charm VHS script — generates a crisp 15-second terminal GIF for DevShelf
# Install VHS: https://github.com/charmbracelet/vhs
# Run: vhs assets/demo.tape

Output assets/demo.gif

Set Shell "bash"
Set FontSize 16
Set Width 1100
Set Height 620
Set Padding 20
Set Theme "TokyoNight"
Set TypingSpeed 40ms

Type "# 1. Search 576 CI-audited zero-paywall tools & free APIs"
Enter
Sleep 600ms
Type `npx @ritualdev-lab/devshelf search "postgres"`
Enter
Sleep 3s

Type "# 2. Search open-source AI & MCP developer tools"
Enter
Sleep 600ms
Type `npx @ritualdev-lab/devshelf search "mcp"`
Enter
Sleep 3s

Type "# 3. Connect DevShelf to Claude Desktop / Cursor via MCP"
Enter
Sleep 600ms
Type "npx @ritualdev-lab/devshelf --help"
Enter
Sleep 2s
Loading