pi-cursor-sdk
Run Cursor's agent loop inside the pi coding agent via local Cursor SDK agents, with native model selection, thinking controls, fast/plan modes, image input, an
What is pi-cursor-sdk?
Run Cursor's agent loop inside the pi coding agent via local Cursor SDK agents, with native model selection, thinking controls, fast/plan modes, image input, and MCP-bridged pi tools.
Overview of pi-cursor-sdk
What it is
pi-cursor-sdk runs Cursor's SDK agent inside the Pi coding agent. It connects Cursor's agent loop to Pi sessions and extension tools. The agent runs locally; it sends model requests to Cursor and returns replies and tool activity to Pi.
Key features
- Runs Cursor's agent loop locally inside Pi's terminal UI.
- Enables native model selection with context window and thinking controls.
- Supports fast/plan modes and image input.
- Bridges Pi extension tools to Cursor as
pi__*MCP tools. - Provides commands for billing usage, session management, and agent configuration.
- Offers optional Cursor Cloud runtime for remote agent execution.
Use cases
Use pi-cursor-sdk to run Cursor-powered agents from within Pi's terminal interface. It suits developers who want to use Cursor models and agent modes while keeping their workflow inside Pi. It supports local and cloud agent runs, image attachment, and controlled tool surfaces for development and testing.
Getting started
Requirements: Node.js 24+, Pi 0.87.1+, and an API key for Cursor SDK. Install the package and start a session with a Cursor model:bashpi install npm:pi-cursor-sdkpi --model cursor/grok-4.6Inside Pi, run /login, select Use an API key → Cursor, paste your key, run /cursor-refresh-models, then enter your prompt. For further options, see the repository README.
License and pricing
License: MIT. Pricing type: open source. No additional pricing information is stated in the metadata or README.
Based on the project's public README and repository metadata.