opencode-promptforge 1.0.0

package/README.md

@@ -0,0 +1,46 @@
+# opencode-promptforge
+
+OpenCode plugin for PromptForge — search and retrieve AI prompts from your terminal.
+
+## Installation
+
+Add to your `opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-promptforge"]
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_prompts` | Search prompts by keyword, model, or category |
+| `get_prompt` | Retrieve full prompt content by ID |
+| `get_trending_prompts` | Get trending prompts |
+
+## Usage
+
+Once installed, ask the AI in any opencode session:
+
+- *"Search PromptForge for prompts about TypeScript"*
+- *"Get the full content of prompt abc-123"*
+- *"What's trending on PromptForge?"*
+
+## Development
+
+```bash
+cd opencode-plugin
+npm install
+```
+
+For local testing, copy to your opencode plugins directory:
+
+```bash
+cp index.js ~/.config/opencode/plugins/promptforge.js
+```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+import { tool } from "@opencode-ai/plugin";
+
+const BASE_URL = process.env.PROMPT_FORGE_URL || "https://promptforge-rose.vercel.app";
+
+async function fetchApi(path) {
+  const res = await fetch(`${BASE_URL}${path}`);
+  if (!res.ok) throw new Error(`API error: ${res.status}`);
+  return res.json();
+}
+
+export const PromptForgePlugin = async () => {
+  return {
+    tool: {
+      search_prompts: tool({
+        description: "Search the PromptForge library for AI prompts by keyword, model, or category. Returns matching prompts with metadata.",
+        args: {
+          q: tool.schema.string({ description: "Search query" }),
+          model: tool.schema.string({ description: "Filter by model: chatgpt, claude, gemini, etc.", optional: true }),
+          category: tool.schema.string({ description: "Filter by category slug: coding, seo, marketing, etc.", optional: true }),
+          sort: tool.schema.string({ description: "Sort order: trending, newest, most-upvoted, most-saved", optional: true }),
+          limit: tool.schema.number({ description: "Max results (1-50)", optional: true }),
+        },
+        async execute(args) {
+          const params = new URLSearchParams();
+          if (args.q) params.set("q", args.q);
+          if (args.model) params.set("model", args.model);
+          if (args.category) params.set("category", args.category);
+          if (args.sort) params.set("sort", args.sort);
+          if (args.limit) params.set("limit", String(Math.min(args.limit, 50)));
+          const data = await fetchApi(`/api/v1/prompts?${params}`);
+          const prompts = (data.data || []).map(p => ({
+            id: p.id,
+            title: p.title,
+            description: p.description,
+            model: p.model,
+            author: p.author?.displayName || p.author?.username || "anonymous",
+            category: p.category?.name || null,
+            url: `${BASE_URL}/prompts/${p.id}`,
+            stats: p.stats,
+          }));
+          return JSON.stringify({ count: prompts.length, total: data.pagination?.total || 0, prompts }, null, 2);
+        },
+      }),
+
+      get_prompt: tool({
+        description: "Get a specific prompt by ID with full content and all metadata.",
+        args: {
+          id: tool.schema.string({ description: "Prompt ID (UUID)" }),
+        },
+        async execute(args) {
+          const data = await fetchApi(`/api/v1/prompts/${args.id}`);
+          return JSON.stringify({
+            id: data.id,
+            title: data.title,
+            description: data.description,
+            content: data.content,
+            model: data.model,
+            author: data.author,
+            category: data.category,
+            tags: data.tags,
+            stats: data.stats,
+            url: `${BASE_URL}/prompts/${data.id}`,
+          }, null, 2);
+        },
+      }),
+
+      get_trending_prompts: tool({
+        description: "Get currently trending AI prompts.",
+        args: {
+          limit: tool.schema.number({ description: "Max results (1-50)", optional: true }),
+        },
+        async execute(args) {
+          const limit = args.limit ? Math.min(args.limit, 50) : 10;
+          const data = await fetchApi(`/api/v1/prompts?sort=trending&limit=${limit}`);
+          const prompts = (data.data || []).map(p => ({
+            id: p.id,
+            title: p.title,
+            model: p.model,
+            author: p.author?.displayName || p.author?.username || "anonymous",
+            url: `${BASE_URL}/prompts/${p.id}`,
+            stats: p.stats,
+          }));
+          return JSON.stringify({ count: prompts.length, prompts }, null, 2);
+        },
+      }),
+    },
+  };
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "opencode-promptforge",
+  "version": "1.0.0",
+  "description": "OpenCode plugin for PromptForge — search and retrieve AI prompts from your terminal",
+  "type": "module",
+  "main": "index.js",
+  "files": [
+    "index.js"
+  ],
+  "keywords": [
+    "opencode",
+    "plugin",
+    "promptforge",
+    "ai",
+    "prompts"
+  ],
+  "publishConfig": { "access": "public" },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jordan-thirkle/promptforge.git",
+    "directory": "opencode-plugin"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.15.12"
+  }
+}