promptgraph-mcp 2.9.59 → 2.9.61

package/README.md

@@ -1,6 +1,6 @@
 # PromptGraph
 
-**Semantic skill router and marketplace for Claude Code, OpenCode, and more.**
+**Semantic skill router and marketplace for Claude Code, Claude Desktop, and OpenCode.**
 
 Instead of loading every `.md` skill into context, Claude calls `pg_search` and loads only the skill it needs — saving 20k+ tokens per session.
 
@@ -18,7 +18,7 @@ Instead of loading every `.md` skill into context, Claude calls `pg_search` and
 - **Any local folder** — `pg add-dir <path>` indexes a folder that isn't a default source
 - **Marketplace** — browse and install community skill bundles via TUI or MCP tools
 - **Publishing** — publish skills/bundles to the registry hands-off via GitHub CLI
-- **Multi-platform** — Claude Code, OpenCode, Claude Desktop, Cursor, Windsurf, Cline, Codex
+- **Multi-platform** — verified on Claude Code, Claude Desktop & OpenCode; best-effort config for Cursor, Windsurf, Cline, Codex
 
 ---
 
@@ -48,15 +48,17 @@ Then restart your editor — the `promptgraph` MCP server will be available.
 
 ## Supported platforms
 
-| Platform | Config written | Skills directory |
-|---|---|---|
-| `claude-code` | `~/.claude/settings.json` | `~/.claude/skills-store` |
-| `claude-desktop` | `%APPDATA%/Claude/claude_desktop_config.json` | `~/.claude/skills-store` |
-| `opencode` | `~/.config/opencode/opencode.json` | `~/.config/opencode/skills` |
-| `cursor` | `.cursor/mcp.json` | `~/.cursor/skills` |
-| `windsurf` | `.codeium/windsurf/mcp_config.json` | `~/.codeium/windsurf/skills` |
-| `cline` | `.vscode/mcp.json` | `~/.vscode/skills` |
-| `codex` | `~/.codex/config.yaml` | `~/.codex/skills` |
+**Claude Code**, **Claude Desktop**, and **OpenCode** are verified end-to-end. The others are best-effort — the MCP config path/format is implemented but untested, so `pg setup` warns before writing. If you run one, please [report results](https://github.com/NeiP4n/promptgraph/issues).
+
+| Platform | Status | Config written | Skills directory |
+|---|---|---|---|
+| `claude-code` | ✅ verified | `~/.claude/settings.json` | `~/.claude/skills-store` |
+| `claude-desktop` | ✅ verified | `claude_desktop_config.json` (OS-specific) | `~/.claude/skills-store` |
+| `opencode` | ✅ verified | `~/.config/opencode/opencode.json` | `~/.config/opencode/skills` |
+| `cursor` | ⚠️ untested | `~/.cursor/mcp.json` | `~/.cursor/skills` |
+| `windsurf` | ⚠️ untested | `~/.codeium/windsurf/mcp_config.json` | `~/.codeium/windsurf/skills` |
+| `cline` | ⚠️ untested | `~/.vscode/mcp.json` | `~/.vscode/skills` |
+| `codex` | ⚠️ untested | `~/.codex/config.json` | `~/.codex/skills` |
 
 ---
 

package/commands/marketplace.js

@@ -21,10 +21,10 @@ export default async function handler(args, bin) {
     process.exit(result.errors.length > 0 ? 1 : 0);
   }
 
-  if (!process.stdout.isTTY) {
-    error('marketplace TUI requires an interactive terminal');
-    process.exit(1);
-  }
+  // Interactive TUI needs a real terminal. Non-tty hosts (opencode, pipes, CI)
+  // get a plain text listing instead of a broken escape-sequence dump.
+  const interactive = process.stdout.isTTY && process.stdin.isTTY;
+
   const { browseMarketplace, browseBundles, installSkill, installBundle, installBundleBg, validateAndPruneMarketplace } = await import('../marketplace.js');
   const { loadConfig: _lcMkt } = await import('../config.js');
   const { getDb: _getDbMkt } = await import('../db.js');
@@ -88,6 +88,12 @@ export default async function handler(args, bin) {
     }
   } catch {}
 
+  // Non-interactive host (opencode, pipe, CI): print a plain list, no escape codes.
+  if (!interactive) {
+    printPlainList(Array.isArray(skills) ? skills : [], bundlesWithCounts, installedSet);
+    process.exit(0);
+  }
+
   const { runTUI } = await import('../tui.js');
   const { loadConfig: _lcR, saveConfig: _scR, SKILLS_STORE_DIR: _ssR } = await import('../config.js');
   const { getDb: _getDbR } = await import('../db.js');
@@ -155,3 +161,38 @@ export default async function handler(args, bin) {
   );
   process.exit(0);
 }
+
+// Plain, escape-code-free listing for non-interactive hosts (opencode, pipes, CI).
+function printPlainList(skills, bundles, installedSet) {
+  const tools = process.stdout.isTTY ? chalk : new Proxy({}, { get: () => (s) => s });
+  const c = tools;
+
+  console.log(c.bold(`\nPromptGraph marketplace — ${skills.length} skills · ${bundles.length} bundles\n`));
+
+  if (bundles.length) {
+    console.log(c.bold('Bundles'));
+    for (const b of bundles) {
+      const installed = installedSet.has(b.id) ? '✓ ' : '  ';
+      const count = b.skillCount != null ? `${b.skillCount} sk` : '';
+      const wrench = b.has_tools ? ' 🔧' : '';
+      const desc = (b.description || '').replace(/\s+/g, ' ').slice(0, 60);
+      console.log(`${installed}${c.cyan((b.name || b.id).padEnd(28))} ${count.padEnd(8)}${wrench}  ${c.gray(desc)}`);
+      console.log(`    ${c.gray(`pg bundle install ${b.id}`)}${b.repo_url ? c.gray(`   ↗ github.com/${b.repo_url}`) : ''}`);
+    }
+    console.log();
+  }
+
+  if (skills.length) {
+    console.log(c.bold('Skills'));
+    for (const s of skills) {
+      const installed = installedSet.has(s.id) || (s.code && installedSet.has(s.code)) ? '✓ ' : '  ';
+      const desc = (s.description || '').replace(/\s+/g, ' ').slice(0, 60);
+      console.log(`${installed}${c.cyan((s.name || s.id).padEnd(28))} ${(s.code || '').padEnd(10)}  ${c.gray(desc)}`);
+      console.log(`    ${c.gray(`pg install ${s.code || s.id}`)}`);
+    }
+    console.log();
+  }
+
+  console.log(c.gray('Tip: this plain list appears because the terminal is non-interactive (e.g. opencode).'));
+  console.log(c.gray('     Run `pg marketplace` in a native terminal for the interactive browser.\n'));
+}

package/commands/setup.js

@@ -9,15 +9,25 @@ export default async function handler(args, bin) {
 
   if (!platformId) {
     section('Detected platforms');
-    detectPlatforms().forEach(p => info(`${chalk.white(p.id.padEnd(16))} ${chalk.gray(p.name)}`));
-    console.log(chalk.gray('\n  Usage: pg setup <platform>\n'));
-    console.log(chalk.gray('  Platforms: claude-code, claude-desktop, opencode, cursor, windsurf, cline, codex\n'));
+    detectPlatforms().forEach(p => {
+      const tag = p.verified ? chalk.green('verified') : chalk.yellow('untested');
+      info(`${chalk.white(p.id.padEnd(16))} ${chalk.gray(p.name.padEnd(20))} ${tag}`);
+    });
+    console.log(chalk.gray('\n  Usage: pg setup <platform>'));
+    console.log(chalk.green('  Verified: ') + chalk.gray('claude-code, claude-desktop, opencode'));
+    console.log(chalk.yellow('  Untested: ') + chalk.gray('cursor, windsurf, cline, codex') + chalk.gray('  (best-effort — please report results)\n'));
     process.exit(0);
   }
 
   const platform = PLATFORMS[platformId];
   if (!platform) { error(`Unknown platform: ${platformId}`); process.exit(1); }
 
+  if (!platform.verified) {
+    console.log(chalk.yellow(`  ⚠ ${platform.name} is untested.`) + chalk.gray(' Verified: claude-code, claude-desktop, opencode.'));
+    console.log(chalk.gray(`    The MCP config format/path below is best-effort and may need manual fixing.`));
+    console.log(chalk.gray(`    If it works (or doesn't), please report: https://github.com/NeiP4n/promptgraph/issues\n`));
+  }
+
   // 1. Write MCP config
   try {
     platform.addMcp(platform);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptgraph-mcp",
-  "version": "2.9.59",
+  "version": "2.9.61",
   "files": [
     "*.js",
     "commands/",

package/platform.js

@@ -39,41 +39,51 @@ function addOpenCodeMcp(configPath) {
   }
 }
 
+// `verified: true` means the MCP config format + skills dir were actually tested
+// on that platform. Unverified entries are best-effort (config path/format may be
+// wrong) — `pg setup` warns before writing so we never imply false support.
 export const PLATFORMS = {
   'claude-code': {
     name: 'Claude Code',
     configPath: path.join(HOME, '.claude', 'settings.json'),
     addMcp: (config) => addStdMcp(config.configPath),
+    verified: true,
+  },
+  'opencode': {
+    name: 'OpenCode',
+    configPath: getOpenCodeConfig(),
+    addMcp: (config) => addOpenCodeMcp(config.configPath),
+    verified: true,
   },
   'claude-desktop': {
     name: 'Claude Desktop',
     configPath: getClaudeDesktopConfig(),
     addMcp: (config) => addStdMcp(config.configPath),
+    verified: true,
   },
   'cline': {
     name: 'Cline (VS Code)',
     configPath: path.join(HOME, '.vscode', 'mcp.json'),
     addMcp: (config) => addClineMcp(config.configPath),
+    verified: false,
   },
   'codex': {
     name: 'OpenAI Codex CLI',
     configPath: path.join(HOME, '.codex', 'config.json'),
     addMcp: (config) => addStdMcp(config.configPath),
+    verified: false,
   },
   'cursor': {
     name: 'Cursor',
     configPath: path.join(HOME, '.cursor', 'mcp.json'),
     addMcp: (config) => addStdMcp(config.configPath),
+    verified: false,
   },
   'windsurf': {
     name: 'Windsurf',
     configPath: path.join(HOME, '.codeium', 'windsurf', 'mcp_config.json'),
     addMcp: (config) => addStdMcp(config.configPath),
-  },
-  'opencode': {
-    name: 'OpenCode',
-    configPath: getOpenCodeConfig(),
-    addMcp: (config) => addOpenCodeMcp(config.configPath),
+    verified: false,
   },
 };