Skip to main content
Use Pluxx in Cursor when you want a native Cursor plugin bundle plus optional Cursor CLI refine and review passes.

​
What Cursor Consumes

Pluxx builds the Cursor target into dist/cursor/. Cursor consumes:
  • .cursor-plugin/plugin.json
  • skills/
  • commands/
  • agents/
  • rules/ when platforms.cursor.rules is configured
  • hooks/hooks.json
  • mcp.json
  • AGENTS.md
The required manifest is .cursor-plugin/plugin.json. Pluxx wires plugin-native rules, hooks, skills, commands, agents, and MCP config from that root.

​
Build And Install

npx @orchid-labs/pluxx build --target cursor --install
If you already built the bundle, install it directly: 
npx @orchid-labs/pluxx install --target cursor
Pluxx installs the local Cursor bundle to:
  • ~/.cursor/plugins/local/<plugin>
If the plugin defines local hook commands, add --trust or confirm the trust prompt during install.

​
Agent-Driven Refinement

Build and install are deterministic. Cursor only does model work when you explicitly run an agent pass: 
npx @orchid-labs/pluxx agent prepare
npx @orchid-labs/pluxx agent run review --runner cursor --no-verify
Use Cursor for:
  • iterative instruction cleanup
  • taxonomy review
  • host-specific scaffold review

​
Cursor-Specific Caveats

  • Headless Pluxx runs target the official Cursor CLI binary agent. Older installs that only expose cursor-agent are still supported as a fallback.
  • Real Cursor CLI runs require Cursor auth. Use your normal Cursor CLI login flow or provide CURSOR_API_KEY for scripted runs.
  • Use the Cursor app to verify plugin presence, installed skills, and commands. Cursor CLI is the runner surface for Pluxx agent passes, not the strongest plugin-discovery proof surface.
  • Cursor plugin hooks live inside hooks/hooks.json in the plugin bundle. Project hooks in .cursor/hooks.json are a separate surface and are not auto-installed by Pluxx.
  • Cursor subagents under .cursor/agents or ~/.cursor/agents are also separate from the plugin bundle. Pluxx installs plugin agents/, not project-level subagents.