Skip to content

Align commands to cross-plugin parity (rename codegen→generate-spec, add 8 commands) - #8

Merged
christosgkoros merged 2 commits into
mainfrom
align-plugin-command-parity
Aug 2, 2026
Merged

Align commands to cross-plugin parity (rename codegen→generate-spec, add 8 commands)#8
christosgkoros merged 2 commits into
mainfrom
align-plugin-command-parity

Conversation

@christosgkoros

Copy link
Copy Markdown
Contributor

Summary

Brings the Cursor plugin to the canonical 17-command set shared with the Claude Code plugin (the source of truth) and the Antigravity extension. Cursor previously had 9 commands; this adds the missing 8 and renames one, so all three plugins expose the same surface.

Auth model is unchanged: API key only (the hosted server uses a bearer header; OAuth stays disabled to avoid Cursor's login loop). The new CLI-driven commands authenticate with the same POSTMAN_API_KEY.

Rename

  • /postman:codegen/postman:generate-spec, reworked from "generate client code" to "generate or update an OpenAPI 3.0 spec by scanning the codebase," matching Claude Code's generate-spec. References updated in the README, routing skill, and knowledge skill.

Added (8)

Translated from Claude Code (kept Cursor's frontmatter/format conventions):

  • /postman:run-collection — run a collection with the Postman CLI
  • /postman:send-request — send a single HTTP request with the Postman CLI
  • /postman:list-flows — list Flows / resolve a name to an ID
  • /postman:trigger-flow — trigger a deployed Flow
  • /postman:deploy-flow — deploy a Flow (confirms before the mutating action)
  • /postman:get-flow-run — inspect a Flow run by Run ID

The Flow, run-collection, and send-request commands drive the Postman CLI (not MCP), so they're independent of MCP mode; each documents the CLI dependency.

Translated from the Antigravity extension (adapted to Cursor's .mcp.json keys and API-key auth):

  • /postman:use-local — rewrite .mcp.json to the local stdio package (npx @postman/postman-mcp-server@latest, POSTMAN_API_KEY)
  • /postman:use-remote — rewrite .mcp.json back to the hosted server (https://mcp.postman.com/mcp, API-key bearer header — not OAuth)

Housekeeping

  • README command list updated to all 17 (+ routing table and plugin-structure tree)
  • Version bumped 1.1.01.2.0; CHANGELOG entry added
  • Existing shared command bodies (docs, learn, mock, search, security, setup, sync, test) left unchanged apart from a one-line codegengenerate-spec reference fix in setup/search

Generated with Claude Code

christosgkoros and others added 2 commits August 2, 2026 17:34
… add 8 commands)

Bring the Cursor plugin to the canonical 17-command set shared with the
Claude Code and Antigravity plugins.

- Rename /postman:codegen -> /postman:generate-spec, reworked to generate/update
  an OpenAPI 3.0 spec from the codebase (matches the Claude Code command).
- Add 8 commands: run-collection, send-request, list-flows, trigger-flow,
  deploy-flow, get-flow-run (CLI-driven), plus use-local / use-remote
  (toggle .mcp.json transport, API-key auth, no OAuth).
- Update README command list (all 17), routing + knowledge skills, and
  CHANGELOG; bump version 1.1.0 -> 1.2.0.

Co-Authored-By: Claude <noreply@anthropic.com>
… command (18-command set)

Client code generation FROM a Postman collection was the original codegen
capability; generate-spec (spec FROM code) is different. Restore it as a
distinct command so the canonical set is 18.

- Add commands/generate-client.md (MCP-tool-driven; Code/Full mode note).
- Repoint client-codegen references (setup, search, routing + knowledge
  skills) at generate-client; keep generate-spec for spec-from-code.
- README updated to 18 commands; CHANGELOG [1.2.0] lists generate-client.
- Version unchanged (1.2.0).

Co-Authored-By: Claude <noreply@anthropic.com>
@christosgkoros
christosgkoros merged commit f5ea7c5 into main Aug 2, 2026
1 check passed
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