Skip to content

feat: add plugin listing metadata, logos, keywords and server.json description - #368

Draft
Alenroyfeild wants to merge 1 commit into
devfrom
agy/anti2-PLUGIN-LISTING
Draft

Alenroyfeild wants to merge 1 commit into
devfrom
agy/anti2-PLUGIN-LISTING

Conversation

@Alenroyfeild

Copy link
Copy Markdown
Owner

Problem

  • Plugin listing metadata across Claude Code, OpenAI Codex, Cursor, and the MCP registry was incomplete:
    • .codex-plugin/plugin.json lacked the required interface metadata block.
    • Logos were absent from all plugin manifests and repository assets.
    • Keywords/tags were inconsistent across clients and lacked core terms (session-memory, decisions, guards, markdown).
    • server.json description did not reflect the approved concise listing copy.

Fix

  1. Assets & Logos:
    • Added approved logo files from inbox/drafts/logo-claude/ into assets/ (referenced via ./ paths).
    • Validated that all SVG XML and PNG binary structures open cleanly.
  2. Client-Specific Official Schema Fields:
    • OpenAI Codex (.codex-plugin/plugin.json):
      • Doc URL: https://developers.openai.com/plugins/deploy/submission
      • Added interface block with displayName ("AI Dev Workspace", <= 30 chars), shortDescription ("Memory your AI agents share", <= 30 chars), longDescription (approved copy), developerName ("Alenroyfeild"), category ("Productivity"), brandColor ("#4F46E5"), brandColorDark ("#6366F1"), logo ("./assets/mark-square.svg"), logoDark ("./assets/mark-square-dark.svg"), and composerIcon ("./assets/icon.svg").
      • capabilities: The official documentation defines no enum values for local stdio/Markdown task memory plugins; as specified, the field is left out.
    • Cursor (.cursor-plugin/plugin.json & .cursor-plugin/marketplace.json):
      • Doc URL: https://cursor.com/docs/reference/plugins
      • plugin.json: Added displayName ("AI Dev Workspace"), logo ("./assets/mark-square.svg"), and canonical keywords array. Kept approved Cursor long description.
      • marketplace.json: Added category ("Productivity") and tags (canonical keywords).
    • Claude Code (.claude-plugin/plugin.json & .claude-plugin/marketplace.json):
      • Doc URL: https://code.claude.com/docs/en/plugins/manifest-reference
      • plugin.json: Added displayName ("AI Dev Workspace"), icon ("./assets/icon.svg"), and canonical keywords array. Kept approved Claude long description.
      • marketplace.json: Set category ("Productivity") and updated tags to canonical keywords.
    • MCP Registry (server.json):
      • Updated description to "Local Markdown task memory shared by Claude Code and Codex over stdio MCP."
  3. Automated Verification:
    • Added tests/test_plugin_listing.py verifying shared copy, canonical keywords, interface fields, server.json description, and existence/validity of all referenced image assets.
    • Added changelog.d/agy-anti2-PLUGIN-LISTING.md.

Verification

  • tests/test_plugin_listing.py: 5/5 tests passed.
  • Full plugin test suite: 88 passed.
  • Packaging tests: 7/7 passed.
  • bin/release-smoke: 15/15 passed in 10.8s.
  • Full test suite: 1419 passed (4 skipped) in an isolated temporary HOME directory.
  • git diff --check: 100% clean.
  • All image assets validated and open cleanly.

Tier: T2 (plugin listing & metadata).
Draft PR to dev (stays draft until after the beta.7 tag).
Gate: Anti1 first-pass review, Claude second peer.

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