Repository navigation
Add Perps (josystems) third-party plugin - #1052
Draft
cursor[bot] wants to merge 1 commit into
Draft
cursor[bot] wants to merge 1 commit into
cursor[bot] wants to merge 1 commit into
Conversation
Co-authored-by: Danny Jiang <[email protected]>
Summary
Adds the Perps plugin under
third_party/josystems/, copied from the plugin the publisher's GitHub repository already ships (.cursor-plugin/plugin.jsonat commitd5d4cdb)..cursor-plugin/plugin.json: namejosystems, displayNamePerps, version1.0.2(same as the source), categoryintegrations,"logo": "assets/logo.png", and the nine skill paths from the source manifest.skills/: all nine skills copied unchanged (perps-boss,pnl-tracker,forensics, and six undersub-skills/).assets/logo.png: the publisher's 1024x1024 PNG. The submittedlogo_urlis a GitHubblob/page that returns HTML, so I downloaded its raw form (https://github.com/BadmonLano/perps/raw/main/assets/perps_logo.png), which is byte-identical to the repo'sassets/perps_logo.png.LICENSE(MIT) copied from the source repo; new README with install steps.mcp.json: the source repo publishes no MCP server, soplugin.jsonhas nomcpServers..cursor-plugin/marketplace.json..claude-plugin/marketplace.jsonis unchanged.Submission details
josystemsSubmitted description
Perps is an open-source SI perpetual futures trading agent. It scans markets, sizes positions with a leverage ladder the owner controls (default 20x cap, adjustable from 10x to 250x), and manages exits with ratchet profit-taking and peel-offs. Paper mode is on by default, so you can test everything risk-free before going live.
Testing instructions (from the submitter)
Clone github.com/BadmonLano/perps and follow the README quick start.
Copy .env.example to bots/.env. Paper mode is on by default, so no exchange keys or funds are needed.
Run the self-check, then start the bot in paper mode and watch it open and manage simulated positions in the logs.
In-app: install from the repo, ask the agent to "run Perps in paper mode", and confirm it reports positions and P/L. No test credentials are required.
Reviewer notes
PERPS_DRY_RUN=false, the skills drive real leveraged Jupiter Perps trades from a Solana hot wallet (10x minimum, owner cap up to 250x). Reviewers should decide whether this fits the Cursor marketplace.bots/,inbox/,json_relay/,bot_logs/). The plugin does not ship the Python bot.perps-bossallows theBashtool;owner-pingcan send Telegram messages when the owner configures a token.josystems) to match the directory; the source manifest usesperps. Author is the publisher (Bentayga Empire LLC), as in the TaskFuel submission.Validation
node scripts/validate-plugins.mjspasses.Note
High Risk
Skills can drive real leveraged on-chain perps trades (10x–250x) via Bash and signal files; marketplace exposure plus financial-loss potential warrants strict review before merge.
Overview
Adds Perps (
josystems) as a new third-party marketplace plugin underthird_party/josystems/, with matching entries in.cursor-plugin/marketplace.jsonand the root README.The plugin is skills-only (no
mcp.json): nine agent playbooks for operating the external Perps bot—readinginbox/market packets, writingjson_relay/trade signals, PnL, forensics, morning briefs, owner notifications, warden alerts, and learnings distillation. Users must clone and run the Python bot locally; skills assume that repo’sbots/,inbox/,json_relay/, andbot_logs/layout.Also ships
plugin.json(v1.0.2, Bentayga Empire LLC), MITLICENSE, plugin README with paper-mode install steps, and logo reference.perps-bossallows Bash (e.g.send_signal.py);owner-pingcan use Telegram when env vars are set. Docs default to paper trading (PERPS_DRY_RUN=true) but describe live Jupiter Perps execution when dry run is off.Reviewed by Cursor Bugbot for commit 2eddf58. Bugbot is set up for automated code reviews on this repo. Configure here.