Skip to content

Add use-local / use-remote for cross-plugin command parity - #18

Open
christosgkoros wants to merge 2 commits into
mainfrom
align-plugin-command-parity
Open

Add use-local / use-remote for cross-plugin command parity#18
christosgkoros wants to merge 2 commits into
mainfrom
align-plugin-command-parity

Conversation

@christosgkoros

Copy link
Copy Markdown
Contributor

What

Adds two new slash commands to the Claude Code plugin:

  • /postman:use-remote — points the plugin at Postman's hosted remote MCP Server (https://mcp.postman.com/mcp, Full mode, OAuth). This is the plugin's default configuration and preserves the existing X-Source attribution headers.
  • /postman:use-local — points the plugin at the local stdio package (npx @postman/postman-mcp-server@latest), which authenticates with a POSTMAN_API_KEY read from the environment.

Both work by rewriting the plugin's own bundled .mcp.json in place — only the transport changes (remote ↔ local), and the command confirms the switch and prompts a Claude Code restart.

Why

This brings the Claude Code plugin to the canonical 17-command set already shared with the Cursor and Antigravity plugins. The MCP-mode toggle both other plugins already ship (Antigravity's use-local / use-remote) was the missing piece; this closes the parity gap. The semantics mirror the Antigravity commands, adapted to Claude Code's single-file .mcp.json shape (Antigravity rewrites mcp_config.json).

Changes

  • commands/use-local.md, commands/use-remote.md — the two new commands, matching the repo's existing frontmatter schema and prose conventions.
  • .claude-plugin/plugin.json — version 1.3.01.4.0.
  • CHANGELOG.md — new ## [1.4.0] - 2026-08-02 section + compare links.
  • README.md — added both commands to the command table.

No existing commands, skills, or agents were modified. Both CI validators (validate-frontmatter.py, validate-structure.py) pass locally.

Generated with Claude Code

Add two new commands that toggle which Postman MCP Server this plugin
talks to by rewriting the bundled .mcp.json in place:

- /postman:use-remote — hosted server (https://mcp.postman.com/mcp,
  Full mode, OAuth), the plugin default
- /postman:use-local  — local stdio package
  (npx @postman/postman-mcp-server@latest), requires POSTMAN_API_KEY

Brings the Claude Code plugin to the canonical 17-command set already
shared with the Cursor and Antigravity plugins. Bumps version to 1.4.0,
updates CHANGELOG and the README command list. No existing commands,
skills, or agents were modified.

Co-Authored-By: Claude <noreply@anthropic.com>
Add /postman:generate-client — generate typed client code from a Postman
collection. This is the inverse of /postman:generate-spec (which authors an
OpenAPI spec from code); here the collection is the source of truth and code
is the output. Adapted from the Cursor plugin's codegen command to the Claude
Code .md format, with the mcp__postman__* tools enumerated explicitly to
satisfy the repo's frontmatter validator (no wildcard). Requires Full or Code
MCP mode; this plugin defaults to Full.

Updates the CHANGELOG 1.4.0 entry and the README command table. Version stays
at 1.4.0. No existing commands, skills, or agents were modified.

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant