Pincushion

Las partes interesadas fijan comentarios en tu aplicación en vivo; tu agente de codificación de IA lo lee a través de MCP y lo corrige.

Documentación

Pincushion

Teammates and clients pin feedback on your live app in Pincushion. Each pin is a work packet for your coding agent: page URL, CSS selector, screenshot, DOM snippet, viewport and the comment thread. This repository is the plugin marketplace for Claude Code, Codex and Cursor and the MCP registry metadata for pincushion-mcp (npm 1.14.0).

Requires Node.js 22.22 or newer, or Node.js 24. On older Node the server exits at start and the Pincushion tools just don't appear. Check with node --version. Do not put a license key in any MCP config: sign-in writes ~/.pincushion/license-key for you.

Quick start

One repository installs Pincushion in Claude Code, Codex and Cursor. Each host gets the same skills: setup signs you in and links your repo to a project from inside the agent, doctor checks what's missing without changing anything, and pins, critique, implement, resolve, feedback-summary and send-feedback do the work.

Claude Code

claude plugin marketplace add jcooley8/pincushion-plugin
claude plugin install pincushion@pincushion

Start Claude Code in your app's repository and run /pincushion:setup. Then /pincushion:pins lists open feedback and /pincushion:critique https://your-site.example runs a Pincushion crit of that URL. If anything looks off, run /pincushion:doctor.

Codex

codex plugin marketplace add jcooley8/pincushion-plugin
codex plugin add pincushion@pincushion

Start a new Codex task in your app's repository and ask: "Set up Pincushion for this repository." You can also install it from /plugins inside Codex.

Cursor

For a team: in the Cursor dashboard open Plugins & MCPs → Add Marketplace → Import from Repo, enter https://github.com/jcooley8/pincushion-plugin, then install Pincushion from Customize.

For one machine, link the plugin folder into Cursor's local plugins and reload the window (Developer: Reload Window):

git clone --depth 1 https://github.com/jcooley8/pincushion-plugin ~/.pincushion-plugin
mkdir -p ~/.cursor/plugins/local && ln -s ~/.pincushion-plugin/plugins/pincushion ~/.cursor/plugins/local/pincushion

Then ask the agent: "Set up Pincushion for this repository."

To add only the MCP server, without the skills: Add Pincushion to Cursor. That deeplink installs npx -y pincushion-mcp over stdio and sets no license key. Restart Cursor in your app's repository, then follow First steps.

VS Code

code --install-extension pincushion.pincushion-feedback

Or install Pincushion Feedback from the Marketplace. Reload the window in your app's repository, then follow First steps.

To add the server without the extension, put this in .vscode/mcp.json:

{
  "servers": {
    "pincushion": {
      "command": "npx",
      "args": ["-y", "pincushion-mcp@latest"]
    }
  }
}

Cline

Add the pincushion entry from llms-install.md to cline_mcp_settings.json. It is npx -y pincushion-mcp@latest over stdio, with no API key. Pin reads work before sign-in. The same page has the sign-in command.

Any other MCP client

Add this stdio server. Start the client in your app's repository so the server's working directory is that repo. If the client starts somewhere else, append "--project-dir" and the absolute path of the repo to args.

{
  "mcpServers": {
    "pincushion": {
      "command": "npx",
      "args": ["-y", "pincushion-mcp@latest"]
    }
  }
}

First steps

With a plugin installed, run the setup skill (above): it signs you in with a browser link and links the repository to a project without leaving the agent.

Without a plugin, run this in your app's repository:

npx -y pincushion-mcp setup

Setup opens a browser, signs you in, and links the repository to a Pincushion project. Restart the client, then ask: "show my open Pincushion pins."

Before that sign-in the server still starts. get_actionable_pins, get_annotations and get_feedback_summary read pins in this repo's .feedback/ directory, and an empty workspace includes a sample pin that is not saved to your project. claim_pin, fix_and_resolve, cloud pins and critiques need the setup sign-in.

The Pincushion browser extension is optional. Pins can come from shared review links, Pincushion AI critiques, other agents and the REST API.

License

The plugin files in this repository are MIT licensed. The pincushion-mcp package they install carries its own license, published with the package on npm.