Skip to content

Add runapi-mcp plugin#568

Open
runapi-builder wants to merge 2 commits into
wshobson:mainfrom
runapi-builder:add-runapi-mcp
Open

Add runapi-mcp plugin#568
runapi-builder wants to merge 2 commits into
wshobson:mainfrom
runapi-builder:add-runapi-mcp

Conversation

@runapi-builder
Copy link
Copy Markdown

Summary

Adds RunAPI MCP, a media generation plugin that gives Claude Code, Codex, and other MCP hosts access to 130+ AI models across 18 providers.

What it does

  • 8 MCP tools for model discovery, pricing lookup, image/video/music/audio task creation, task polling, balance checks, and LLM chat
  • 2 sub-agents for parallel task execution and model recommendation
  • 4 slash commands: /runapi:gen, /runapi:models, /runapi:balance, /runapi:setup
  • Free catalog tools work without API key (model browsing, pricing)

Models covered

  • Image: Flux, GPT Image 2, Imagen 4, Ideogram V3, Nano Banana, Seedream, Qwen
  • Video: Seedance, Veo 3.1, Kling, Wan, Hailuo, Runway, HappyHorse
  • Music: Suno (v4, v4.5, v5, v5.5)
  • Audio: ElevenLabs (TTS, sound effects, dialogue, transcription)
  • LLM: Claude, GPT, Gemini, DeepSeek

Install

npx @runapi.ai/mcp init claude

Links

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jun 3, 2026

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 95889a32-5323-4229-b32d-d0be391303cb

📥 Commits

Reviewing files that changed from the base of the PR and between c57ca0a and d7db023.

📒 Files selected for processing (4)
  • plugins/runapi-mcp/agents/model-advisor.md
  • plugins/runapi-mcp/agents/task-executor.md
  • plugins/runapi-mcp/commands/balance.md
  • plugins/runapi-mcp/commands/setup.md
✅ Files skipped from review due to trivial changes (1)
  • plugins/runapi-mcp/commands/balance.md
🚧 Files skipped from review as they are similar to previous changes (3)
  • plugins/runapi-mcp/agents/model-advisor.md
  • plugins/runapi-mcp/commands/setup.md
  • plugins/runapi-mcp/agents/task-executor.md

📝 Walkthrough

Summary by CodeRabbit

  • New Features

    • Introduced RunAPI plugin with MCP command support
    • Added model advisor and task executor agents
    • New commands for balance check, quick generation, and model browsing
  • Documentation

    • Detailed setup guide for API key configuration
    • Comprehensive RunAPI overview, installation, and usage instructions
  • Chores

    • Bumped plugin version to 0.1.3

Walkthrough

This PR adds the complete RunAPI MCP plugin integration, including plugin metadata versioning, MCP command configuration, comprehensive documentation, agent orchestration prompts for model discovery and task execution, and user-facing command flows for balance checking, model search, API setup, and quick media generation.

Changes

RunAPI MCP Plugin

Layer / File(s) Summary
Plugin configuration and overview
plugins/runapi-mcp/.claude-plugin/plugin.json, plugins/runapi-mcp/.codex-plugin/plugin.json, plugins/runapi-mcp/.mcp.json, plugins/runapi-mcp/README.md
Plugin version bumped to 0.1.3 across host manifests; .mcp.json configures the runapi MCP command execution with environment-based RUNAPI_API_KEY injection; README documents installation, API key setup, available tools, and reference links.
Agent orchestration (model discovery and task execution)
plugins/runapi-mcp/agents/model-advisor.md, plugins/runapi-mcp/agents/task-executor.md
Model-advisor agent prompt defines workflow for model recommendation: list models with modality filter, fetch detailed info, check pricing, and return slugs grounded in tool data without hardcoded names/prices; task-executor agent prompt specifies single-task handling via create or check operations, with exact service/action/model/params delegation and compact output including task ID, status, URLs, and cost.
User-facing command instructions
plugins/runapi-mcp/commands/balance.md, plugins/runapi-mcp/commands/models.md, plugins/runapi-mcp/commands/setup.md, plugins/runapi-mcp/commands/gen.md
Balance command calls mcp__runapi__check_balance with API key error guidance and constraints on requesting credentials; models command filters and displays catalog via list/info/pricing tool calls; setup command documents environment variable and JSON config file methods with host restart requirement and input constraints; gen command implements quick generation flow: prompt input, model listing with modality filter, info/confirmation gating for video/music/batch, delegation to task-executor agent, and output reporting.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Suggested reviewers

  • wshobson
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Add runapi-mcp plugin' directly and concisely summarizes the main objective of the changeset: adding a new RunAPI MCP plugin to the repository.
Description check ✅ Passed The description provides relevant context about the RunAPI MCP plugin, covering its features, capabilities, models supported, and installation instructions, all of which relate to the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
✨ Simplify code
  • Create PR with simplified code

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🧹 Nitpick comments (7)
plugins/runapi-mcp/agents/task-executor.md (2)

21-23: ⚖️ Poor tradeoff

Consider using action verbs instead of explicit tool names.

The guidelines recommend using action verbs in the markdown body rather than tool-name vocabulary. While the adapter rewrites a conservative set, unrewritten cases may bleed through to hosts like Codex or Cursor.

Consider rephrasing instructions to use action-oriented language where feasible.

As per coding guidelines: Use action verbs in markdown body, not tool-name vocabulary: prefer "open the file" over "use the Read tool". The adapter rewrites a conservative set, but unrewritten cases may bleed through.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/runapi-mcp/agents/task-executor.md` around lines 21 - 23, The
markdown uses explicit tool names (mcp__runapi__create_task,
mcp__runapi__get_task) instead of action verbs; replace those occurrences with
action-oriented instructions (e.g., "create a task with the provided values" and
"retrieve/check a task by ID") and keep the same semantic behavior and return
requirements (compact response: task ID, status, output URLs, cost fields) so
the adapter can rewrite tool references safely while preserving the calls to
mcp__runapi__create_task and mcp__runapi__get_task under the hood.

2-4: 💤 Low value

Align description with "Use when…" pattern.

The coding guidelines specify that the agent description should include a "Use when…" trigger. Consider starting the description with "Use when" for consistency with the documented pattern.

📝 Optional rephrasing
 description: >-
-  Media task execution agent. Delegates here for create_task calls so the
-  main conversation stays focused. Spawn one per task for parallel generation.
+  Use when creating or checking RunAPI media tasks while keeping the main
+  conversation focused. Spawn one per task for parallel generation.

Based on learnings: Agents frontmatter must include: name, description (with "Use when…" trigger), model: opus|sonnet|haiku|inherit, optional tools:, optional color:.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/runapi-mcp/agents/task-executor.md` around lines 2 - 4, Update the
frontmatter in task-executor.md so the description field begins with the
required "Use when…" trigger (e.g., "Use when delegating media task execution
for create_task calls; spawn one per task for parallel generation.") and
preserve the existing purpose text; ensure the agent frontmatter also includes
the required fields (name and model set to one of opus|sonnet|haiku|inherit) and
any optional tools or color entries so the metadata remains valid.
plugins/runapi-mcp/commands/balance.md (1)

8-8: ⚖️ Poor tradeoff

Consider using action verbs instead of explicit tool names.

The guidelines recommend using action verbs in the markdown body rather than tool-name vocabulary. While the adapter rewrites a conservative set, unrewritten cases may bleed through to hosts like Codex or Cursor.

As per coding guidelines: Use action verbs in markdown body, not tool-name vocabulary: prefer "open the file" over "use the Read tool". The adapter rewrites a conservative set, but unrewritten cases may bleed through.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/runapi-mcp/commands/balance.md` at line 8, Replace the explicit
tool-name phrasing "Call `mcp__runapi__check_balance`" with an action-verb
description that avoids exposing the tool identifier directly; for example,
change the sentence to "Invoke the runapi check balance action" or "Execute the
runapi check balance operation" while keeping reference to the underlying
identifier mcp__runapi__check_balance only in code blocks or metadata if needed
(update the text around the symbol in the commands/balance.md content so the
markdown body uses an action verb instead of the raw tool name).
plugins/runapi-mcp/commands/models.md (1)

14-17: ⚖️ Poor tradeoff

Consider using action verbs instead of explicit tool names.

The guidelines recommend using action verbs in the markdown body rather than tool-name vocabulary. While the adapter rewrites a conservative set, unrewritten cases may bleed through to hosts like Codex or Cursor.

As per coding guidelines: Use action verbs in markdown body, not tool-name vocabulary: prefer "open the file" over "use the Read tool". The adapter rewrites a conservative set, but unrewritten cases may bleed through.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/runapi-mcp/commands/models.md` around lines 14 - 17, Replace explicit
tool-name vocabulary in the markdown items by using action verbs and generic
descriptions instead of raw tool identifiers: e.g., reword the line that
mentions mcp__runapi__list_models to "list models with a narrow filter," change
the mcp__runapi__get_model_info reference to "retrieve detailed info for a
single model (include service and action when known)," and change
mcp__runapi__check_pricing to "check pricing for the model" — update items 2–5
to use these action-verb phrasings while keeping the same semantics.
plugins/runapi-mcp/agents/model-advisor.md (2)

2-4: 💤 Low value

Align description with "Use when…" pattern.

The coding guidelines specify that the agent description should include a "Use when…" trigger. While the current description mentions "Delegates here when the user needs...", consider starting with "Use when" for consistency with the documented pattern.

📝 Optional rephrasing
 description: >-
-  Model discovery and recommendation agent. Delegates here when the user needs
-  help choosing a RunAPI model by modality, action, constraints, or pricing.
+  Use when the user needs help choosing a RunAPI model by modality, action,
+  constraints, or pricing. Handles model discovery and recommendations.

Based on learnings: Agents frontmatter must include: name, description (with "Use when…" trigger), model: opus|sonnet|haiku|inherit, optional tools:, optional color:.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/runapi-mcp/agents/model-advisor.md` around lines 2 - 4, Update the
frontmatter description to follow the "Use when…" pattern by replacing the
current sentence that begins "Delegates here when the user needs..." with a
leading "Use when" trigger (e.g., "Use when the user needs help choosing a
RunAPI model by modality, action, constraints, or pricing."). Ensure the
frontmatter includes the required keys (name and model) and that the description
field explicitly begins with "Use when" and concisely describes the triggering
conditions; keep optional keys (tools, color) as needed.

19-23: ⚖️ Poor tradeoff

Consider using action verbs instead of explicit tool names.

The guidelines recommend using action verbs in the markdown body rather than tool-name vocabulary (e.g., "open the file" instead of "use the Read tool"). While the adapter rewrites a conservative set, unrewritten cases may bleed through to hosts like Codex or Cursor.

Consider rephrasing instructions to use action-oriented language where feasible, though explicit tool names may be acceptable if the adapter handles them.

As per coding guidelines: Use action verbs in markdown body, not tool-name vocabulary: prefer "open the file" over "use the Read tool". The adapter rewrites a conservative set, but unrewritten cases may bleed through.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/runapi-mcp/agents/model-advisor.md` around lines 19 - 23, The
markdown uses explicit tool names (e.g., `mcp__runapi__list_models`,
`mcp__runapi__get_model_info`, `mcp__runapi__check_pricing`, and `create_task`)
instead of action-oriented phrasing; update the steps to use action verbs in the
body while keeping the precise tool identifiers for implementation/reference
only (for example, reword "Call `mcp__runapi__list_models`..." to "List models
with the narrowest useful modality/service/action filter" and similarly change
"call `mcp__runapi__get_model_info`" to "retrieve model info for promising
candidates" and "call `mcp__runapi__check_pricing`" to "check pricing when cost
matters"), and ensure the final step still provides the exact service, action,
and model slug required for create_task.
plugins/runapi-mcp/commands/gen.md (1)

15-16: ⚡ Quick win

Prefer action verbs over explicit tool names.

Lines 15-16 and 22 directly reference MCP tool names (mcp__runapi__list_models, mcp__runapi__get_model_info, mcp__runapi__check_pricing). Per the coding guidelines, command instructions should use action verbs instead of tool-name vocabulary to ensure better cross-harness transpilation.

♻️ Proposed refactor
 1. If `$ARGUMENTS` is empty, ask for the prompt or task description.
-2. Call `mcp__runapi__list_models` with the most likely modality filter.
-3. Call `mcp__runapi__get_model_info` with the selected service, action, and model slug, then obey returned input rules.
+2. List RunAPI models with the most likely modality filter.
+3. Get model info for the selected service, action, and model slug, then obey returned input rules.
 4. If the selected task is video, music, or a batch, ask for confirmation before creating it.
 Do not invent model slugs.
-Do not quote prices without `mcp__runapi__check_pricing`.
+Do not quote prices without checking pricing first.
 Do not describe generated media content.

As per coding guidelines: Use action verbs in markdown body, not tool-name vocabulary: prefer "open the file" over "use the Read tool". The adapter rewrites a conservative set, but unrewritten cases may bleed through

Also applies to: 22-22

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/runapi-mcp/commands/gen.md` around lines 15 - 16, The markdown uses
explicit MCP tool names (mcp__runapi__list_models, mcp__runapi__get_model_info,
mcp__runapi__check_pricing); update the phrasing to use action verbs instead
(e.g., "list models filtered by modality", "retrieve model info for the selected
service/action/slug", "check model pricing") so instructions are tool-agnostic
and follow the coding guideline — replace occurrences of those exact identifiers
in the text with concise action-verb alternatives while preserving the same
parameters and intent.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/runapi-mcp/agents/model-advisor.md`:
- Around line 1-6: The agent frontmatter in model-advisor.md is missing the
required "name" field; add a top-level name entry to the YAML frontmatter (e.g.,
name: "Model Advisor") and ensure the description includes the required "Use
when…" trigger phrase, keep model set to one of the allowed values (model:
haiku|sonnet|opus|inherit), and optionally include tools: and color: keys if
applicable; update the frontmatter block containing description and model so it
includes name, description (with "Use when…"), model, and any optional
tools/color entries.

In `@plugins/runapi-mcp/agents/task-executor.md`:
- Around line 1-7: Add a required name entry to the YAML frontmatter of
plugins/runapi-mcp/agents/task-executor.md and update the description to include
the required "Use when…" trigger; specifically, in the existing frontmatter that
currently has description, model: inherit and tools, add a top-level name:
"task-executor" (or another concise identifier), change description to start
with a short summary then include a "Use when…" sentence, keep model: inherit
and tools: mcp__runapi__create_task, mcp__runapi__get_task as-is, and optionally
add a color: field if desired so the frontmatter meets the agent guidelines.

In `@plugins/runapi-mcp/commands/balance.md`:
- Around line 1-4: The command frontmatter is missing the required argument-hint
field; update the YAML frontmatter that currently contains only description to
also include an argument-hint entry (e.g., argument-hint: "[none]" or
argument-hint: "") so the frontmatter now contains both description and
argument-hint as required by the guidelines.

In `@plugins/runapi-mcp/commands/setup.md`:
- Around line 1-5: The frontmatter for the RunAPI setup command is missing the
required argument-hint field; update the YAML frontmatter that currently
contains description to also include an argument-hint entry (e.g.,
argument-hint: "" or a short placeholder) so it conforms to the commands
frontmatter requirement; modify the top-of-file frontmatter block that contains
description to add argument-hint.

---

Nitpick comments:
In `@plugins/runapi-mcp/agents/model-advisor.md`:
- Around line 2-4: Update the frontmatter description to follow the "Use when…"
pattern by replacing the current sentence that begins "Delegates here when the
user needs..." with a leading "Use when" trigger (e.g., "Use when the user needs
help choosing a RunAPI model by modality, action, constraints, or pricing.").
Ensure the frontmatter includes the required keys (name and model) and that the
description field explicitly begins with "Use when" and concisely describes the
triggering conditions; keep optional keys (tools, color) as needed.
- Around line 19-23: The markdown uses explicit tool names (e.g.,
`mcp__runapi__list_models`, `mcp__runapi__get_model_info`,
`mcp__runapi__check_pricing`, and `create_task`) instead of action-oriented
phrasing; update the steps to use action verbs in the body while keeping the
precise tool identifiers for implementation/reference only (for example, reword
"Call `mcp__runapi__list_models`..." to "List models with the narrowest useful
modality/service/action filter" and similarly change "call
`mcp__runapi__get_model_info`" to "retrieve model info for promising candidates"
and "call `mcp__runapi__check_pricing`" to "check pricing when cost matters"),
and ensure the final step still provides the exact service, action, and model
slug required for create_task.

In `@plugins/runapi-mcp/agents/task-executor.md`:
- Around line 21-23: The markdown uses explicit tool names
(mcp__runapi__create_task, mcp__runapi__get_task) instead of action verbs;
replace those occurrences with action-oriented instructions (e.g., "create a
task with the provided values" and "retrieve/check a task by ID") and keep the
same semantic behavior and return requirements (compact response: task ID,
status, output URLs, cost fields) so the adapter can rewrite tool references
safely while preserving the calls to mcp__runapi__create_task and
mcp__runapi__get_task under the hood.
- Around line 2-4: Update the frontmatter in task-executor.md so the description
field begins with the required "Use when…" trigger (e.g., "Use when delegating
media task execution for create_task calls; spawn one per task for parallel
generation.") and preserve the existing purpose text; ensure the agent
frontmatter also includes the required fields (name and model set to one of
opus|sonnet|haiku|inherit) and any optional tools or color entries so the
metadata remains valid.

In `@plugins/runapi-mcp/commands/balance.md`:
- Line 8: Replace the explicit tool-name phrasing "Call
`mcp__runapi__check_balance`" with an action-verb description that avoids
exposing the tool identifier directly; for example, change the sentence to
"Invoke the runapi check balance action" or "Execute the runapi check balance
operation" while keeping reference to the underlying identifier
mcp__runapi__check_balance only in code blocks or metadata if needed (update the
text around the symbol in the commands/balance.md content so the markdown body
uses an action verb instead of the raw tool name).

In `@plugins/runapi-mcp/commands/gen.md`:
- Around line 15-16: The markdown uses explicit MCP tool names
(mcp__runapi__list_models, mcp__runapi__get_model_info,
mcp__runapi__check_pricing); update the phrasing to use action verbs instead
(e.g., "list models filtered by modality", "retrieve model info for the selected
service/action/slug", "check model pricing") so instructions are tool-agnostic
and follow the coding guideline — replace occurrences of those exact identifiers
in the text with concise action-verb alternatives while preserving the same
parameters and intent.

In `@plugins/runapi-mcp/commands/models.md`:
- Around line 14-17: Replace explicit tool-name vocabulary in the markdown items
by using action verbs and generic descriptions instead of raw tool identifiers:
e.g., reword the line that mentions mcp__runapi__list_models to "list models
with a narrow filter," change the mcp__runapi__get_model_info reference to
"retrieve detailed info for a single model (include service and action when
known)," and change mcp__runapi__check_pricing to "check pricing for the model"
— update items 2–5 to use these action-verb phrasings while keeping the same
semantics.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 40778de0-7016-422a-91e9-951942669854

📥 Commits

Reviewing files that changed from the base of the PR and between 767d969 and c57ca0a.

📒 Files selected for processing (10)
  • plugins/runapi-mcp/.claude-plugin/plugin.json
  • plugins/runapi-mcp/.codex-plugin/plugin.json
  • plugins/runapi-mcp/.mcp.json
  • plugins/runapi-mcp/README.md
  • plugins/runapi-mcp/agents/model-advisor.md
  • plugins/runapi-mcp/agents/task-executor.md
  • plugins/runapi-mcp/commands/balance.md
  • plugins/runapi-mcp/commands/gen.md
  • plugins/runapi-mcp/commands/models.md
  • plugins/runapi-mcp/commands/setup.md
📜 Review details
🧰 Additional context used
📓 Path-based instructions (4)
plugins/**/{.claude-plugin/plugin.json,agents/*.md,skills/*/SKILL.md,commands/*.md}

📄 CodeRabbit inference engine (.cursor/rules/000-project-conventions.mdc)

Plugin files follow the structure: plugins/<name>/{.claude-plugin/plugin.json, agents/*.md, skills/<name>/SKILL.md, commands/*.md} and are auto-discovered

Files:

  • plugins/runapi-mcp/agents/task-executor.md
  • plugins/runapi-mcp/commands/balance.md
  • plugins/runapi-mcp/commands/models.md
  • plugins/runapi-mcp/.claude-plugin/plugin.json
  • plugins/runapi-mcp/commands/setup.md
  • plugins/runapi-mcp/commands/gen.md
  • plugins/runapi-mcp/agents/model-advisor.md
plugins/*/agents/*.md

📄 CodeRabbit inference engine (.cursor/rules/020-agent-skill-authoring.mdc)

plugins/*/agents/*.md: Agents frontmatter must include: name, description (with "Use when…" trigger), model: opus|sonnet|haiku|inherit, optional tools:, optional color:
Do not name agents default, worker, or explorer — they collide with Codex built-ins

Subagent files must follow format plugins/*/agents/<name>.md for cross-harness transpilation

Files:

  • plugins/runapi-mcp/agents/task-executor.md
  • plugins/runapi-mcp/agents/model-advisor.md
{plugins/*/agents/*.md,plugins/*/skills/*/SKILL.md,plugins/*/commands/*.md}

📄 CodeRabbit inference engine (.cursor/rules/020-agent-skill-authoring.mdc)

{plugins/*/agents/*.md,plugins/*/skills/*/SKILL.md,plugins/*/commands/*.md}: Use action verbs in markdown body, not tool-name vocabulary: prefer "open the file" over "use the Read tool". The adapter rewrites a conservative set, but unrewritten cases may bleed through
Do not reference TodoWrite, the Task spawn tool, or hooks as load-bearing — they don't exist in Codex or Cursor

Files:

  • plugins/runapi-mcp/agents/task-executor.md
  • plugins/runapi-mcp/commands/balance.md
  • plugins/runapi-mcp/commands/models.md
  • plugins/runapi-mcp/commands/setup.md
  • plugins/runapi-mcp/commands/gen.md
  • plugins/runapi-mcp/agents/model-advisor.md
plugins/*/commands/*.md

📄 CodeRabbit inference engine (.cursor/rules/020-agent-skill-authoring.mdc)

Commands frontmatter must include: description, argument-hint

Files:

  • plugins/runapi-mcp/commands/balance.md
  • plugins/runapi-mcp/commands/models.md
  • plugins/runapi-mcp/commands/setup.md
  • plugins/runapi-mcp/commands/gen.md
🧠 Learnings (8)
📓 Common learnings
Learnt from: CR
Repo: wshobson/agents PR: 0
File: .cursor/rules/020-agent-skill-authoring.mdc:0-0
Timestamp: 2026-05-29T19:12:43.515Z
Learning: Applies to plugins/*/agents/*.md : Agents frontmatter must include: `name`, `description` (with "Use when…" trigger), `model: opus|sonnet|haiku|inherit`, optional `tools:`, optional `color:`
📚 Learning: 2026-05-11T13:52:18.563Z
Learnt from: jau123
Repo: wshobson/agents PR: 0
File: :0-0
Timestamp: 2026-05-11T13:52:18.563Z
Learning: In the wshobson/agents repository, all plugin manifest files at `plugins/*/.claude-plugin/plugin.json` follow a consistent 5-field schema: `name`, `version`, `description`, `author`, and `license`. Suggestions to remove any of these fields diverge from the established repository convention. Version-bump PRs should only update the `version` field.

Applied to files:

  • plugins/runapi-mcp/.codex-plugin/plugin.json
  • plugins/runapi-mcp/.claude-plugin/plugin.json
📚 Learning: 2026-05-29T19:12:32.497Z
Learnt from: CR
Repo: wshobson/agents PR: 0
File: .cursor/rules/000-project-conventions.mdc:0-0
Timestamp: 2026-05-29T19:12:32.497Z
Learning: Applies to .claude-plugin/marketplace.json : Never modify `.claude-plugin/marketplace.json` from inside a plugin PR — it's the registry

Applied to files:

  • plugins/runapi-mcp/.claude-plugin/plugin.json
📚 Learning: 2026-05-29T19:12:43.515Z
Learnt from: CR
Repo: wshobson/agents PR: 0
File: .cursor/rules/020-agent-skill-authoring.mdc:0-0
Timestamp: 2026-05-29T19:12:43.515Z
Learning: Applies to plugins/*/commands/*.md : Commands frontmatter must include: `description`, `argument-hint`

Applied to files:

  • plugins/runapi-mcp/commands/gen.md
📚 Learning: 2026-05-29T19:12:32.497Z
Learnt from: CR
Repo: wshobson/agents PR: 0
File: .cursor/rules/000-project-conventions.mdc:0-0
Timestamp: 2026-05-29T19:12:32.497Z
Learning: Applies to commands/** : Do not hand-edit anything under `commands/` — regenerate via `make generate HARNESS=<x>`

Applied to files:

  • plugins/runapi-mcp/commands/gen.md
📚 Learning: 2026-05-29T19:12:43.515Z
Learnt from: CR
Repo: wshobson/agents PR: 0
File: .cursor/rules/020-agent-skill-authoring.mdc:0-0
Timestamp: 2026-05-29T19:12:43.515Z
Learning: Applies to plugins/*/agents/*.md : Agents frontmatter must include: `name`, `description` (with "Use when…" trigger), `model: opus|sonnet|haiku|inherit`, optional `tools:`, optional `color:`

Applied to files:

  • plugins/runapi-mcp/agents/model-advisor.md
📚 Learning: 2026-05-29T19:12:23.170Z
Learnt from: CR
Repo: wshobson/agents PR: 0
File: GEMINI.md:0-0
Timestamp: 2026-05-29T19:12:23.170Z
Learning: Applies to agents/**/*.md : Model assignment can be overridden at the per-agent level via `model:` frontmatter

Applied to files:

  • plugins/runapi-mcp/agents/model-advisor.md
📚 Learning: 2026-05-29T19:12:14.231Z
Learnt from: CR
Repo: wshobson/agents PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-05-29T19:12:14.231Z
Learning: Follow agent design patterns and conventions documented in AGENTS.md

Applied to files:

  • plugins/runapi-mcp/agents/model-advisor.md
🔇 Additional comments (5)
plugins/runapi-mcp/.claude-plugin/plugin.json (1)

1-9: LGTM!

plugins/runapi-mcp/.mcp.json (1)

1-9: LGTM!

plugins/runapi-mcp/README.md (1)

1-56: LGTM!

plugins/runapi-mcp/commands/models.md (1)

1-5: LGTM!

plugins/runapi-mcp/.codex-plugin/plugin.json (1)

2-2: ⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Verify name consistency across plugin manifests.

The Claude plugin manifest uses "name": "runapi" while this Codex manifest uses "name": "runapi-mcp". If both hosts rely on the name field for plugin identity or cross-references, this inconsistency could cause discovery or configuration issues.

Run the following script to check if other plugins follow a consistent naming pattern across Claude and Codex manifests:

#!/bin/bash
# Description: Compare plugin names across Claude and Codex manifests to identify naming patterns

fd -t f 'plugin.json' plugins/ --exec sh -c '
  for f; do
    dir=$(dirname "$f")
    plugin=$(echo "$dir" | cut -d/ -f2)
    host=$(basename "$(dirname "$f")")
    name=$(jq -r ".name" "$f")
    echo "$plugin|$host|$name"
  done
' sh {} + | sort
⛔ Skipped due to learnings
Learnt from: jau123
Repo: wshobson/agents PR: 0
File: :0-0
Timestamp: 2026-05-11T13:52:18.563Z
Learning: In the wshobson/agents repository, all plugin manifest files at `plugins/*/.claude-plugin/plugin.json` follow a consistent 5-field schema: `name`, `version`, `description`, `author`, and `license`. Suggestions to remove any of these fields diverge from the established repository convention. Version-bump PRs should only update the `version` field.
Learnt from: CR
Repo: wshobson/agents PR: 0
File: .cursor/rules/000-project-conventions.mdc:0-0
Timestamp: 2026-05-29T19:12:32.497Z
Learning: Applies to plugins/**/{.claude-plugin/plugin.json,agents/*.md,skills/*/SKILL.md,commands/*.md} : Plugin files follow the structure: `plugins/<name>/{.claude-plugin/plugin.json, agents/*.md, skills/<name>/SKILL.md, commands/*.md}` and are auto-discovered
Learnt from: CR
Repo: wshobson/agents PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-06-02T23:10:39.225Z
Learning: Applies to plugins/*/package.json : Plugin names must be lowercase and hyphen-separated, never use `__` (reserved for adapter namespace separator)

Comment thread plugins/runapi-mcp/agents/model-advisor.md
Comment thread plugins/runapi-mcp/agents/task-executor.md
Comment thread plugins/runapi-mcp/commands/balance.md
Comment thread plugins/runapi-mcp/commands/setup.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant