Skip to content

README.md

Latest commit

 

History

History
200 lines (153 loc) · 5.47 KB

README.md

File metadata and controls

200 lines (153 loc) · 5.47 KB

RUDI Registry

Official registry of MCP stacks, binaries, agents, runtimes, and prompts for the RUDI CLI.

Package Types

Type Description Location
Stack MCP servers with tools catalog/stacks/{id}/
Binary Standalone binaries/CLIs catalog/binaries/{id}.json
Agent AI coding assistants catalog/agents/{id}.json
Runtime Language interpreters catalog/runtimes/{id}.json
Prompt System prompt templates catalog/prompts/{id}.md

Usage

Packages are consumed by the RUDI CLI:

# Search for packages
rudi search whisper

# Install packages
rudi install whisper
rudi install ffmpeg
rudi install node

# List installed
rudi list

Repository Structure

index.json                    # Package index (all metadata)

catalog/
├── stacks/                   # MCP server stacks
│   └── {stack-id}/
│       ├── manifest.json     # Stack metadata
│       └── node/src/ or python/src/
│
├── prompts/                  # Prompt templates
│   └── {prompt-id}.md        # Markdown with YAML frontmatter
│
├── binaries/                 # Binary manifests
│   └── {binary-id}.json
│
├── agents/                   # Agent manifests
│   └── {agent-id}.json
│
└── runtimes/                 # Runtime manifests
    └── {runtime-id}.json

dist/                         # GitHub Releases (binaries)
├── node-20.10.0-darwin-arm64.tar.gz
├── python-3.12-darwin-arm64.tar.gz
└── ffmpeg-6.0-darwin-arm64.tar.gz

Creating a Stack

  1. Create folder: catalog/stacks/{stack-id}/

  2. Add manifest.json:

{
  "id": "my-stack",
  "name": "My Stack",
  "version": "1.0.0",
  "description": "What it does",
  "runtime": "node",
  "command": ["npx", "tsx", "node/src/index.ts"],
  "provides": {
    "tools": ["my_tool_1", "my_tool_2"]
  },
  "requires": {
    "binaries": ["ffmpeg"],
    "secrets": [
      { "name": "MY_API_KEY", "label": "API Key", "required": true }
    ]
  },
  "meta": {
    "author": "Your Name",
    "license": "MIT",
    "category": "productivity",
    "tags": ["example"]
  }
}

  1. Add MCP server code in node/src/index.ts or python/src/server.py

  2. Add entry to index.json under packages.stacks.official

Secrets Flow

When users install a stack with secrets:

  1. rudi install my-stack creates ~/.rudi/stacks/my-stack/.env with placeholders
  2. User runs rudi secrets set MY_API_KEY to add their key
  3. MCP registration reads secrets and injects into agent configs (Claude, Codex, Gemini)

Creating a Prompt

  1. Create file: catalog/prompts/{prompt-id}.md

  2. Add YAML frontmatter + content:

---
name: My Prompt
description: What this prompt does
category: coding
tags:
  - example
author: Your Name
---

# Prompt Title

Your system prompt content here...
  1. Add entry to index.json under packages.prompts.official

Adding a Binary

Binaries use install types to determine how they're installed:

Install Type Source Examples
binary Upstream URL ffmpeg, jq
npm npm registry vercel, wrangler
pip PyPI httpie
system User installs docker, git

Example binary manifest (catalog/binaries/jq.json):

{
  "id": "jq",
  "name": "jq",
  "version": "1.7.1",
  "description": "JSON processor",
  "installType": "binary",
  "binary": "jq",
  "upstream": {
    "darwin-arm64": "https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-macos-arm64",
    "darwin-x64": "https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-macos-amd64",
    "linux-x64": "https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-amd64"
  }
}

Available Stacks

Stack Description Auth
whisper Local audio transcription None
google-workspace Gmail, Sheets, Docs, Drive, Calendar OAuth
google-ai Gemini, Imagen, Veo API Key
openai DALL-E, Whisper, TTS, Sora API Key
notion-workspace Pages, databases, search API Key
slack Messages, channels, files Bot Token
zoho-mail Email via Zoho OAuth
content-extractor YouTube, Reddit, TikTok, articles None
video-editor ffmpeg-based editing None
web-export HTML to PNG/PDF None
ms-office Read .docx/.xlsx None
social-media Twitter, LinkedIn, Facebook, Instagram OAuth
postgres PostgreSQL database queries Connection URL
sqlite SQLite database queries File path

Categories

Stacks: ai-generation, ai-local, productivity, communication, social-media, data-extraction, document-processing, media, deployment, utilities

Binaries: media, data, devops, utilities, ai-ml, version-control

Prompts: coding, writing, creative, utilities, general

URLs

  • Index: https://raw.githubusercontent.com/learn-rudi/registry/main/index.json
  • Stacks: https://raw.githubusercontent.com/learn-rudi/registry/main/catalog/stacks/{id}/
  • Binaries: https://github.com/learn-rudi/registry/releases/download/v1.0.0/

Security

Never include API keys or secrets in the registry. Stacks declare required secrets in manifest.json under requires.secrets. When installed, secrets are stored locally in ~/.rudi/secrets.json with file permissions 0600.

Contributing

See CONTRIBUTING.md for guidelines on adding packages to the registry.

License

MIT