{"_id":"@0xkobold/pi-cursor","name":"@0xkobold/pi-cursor","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@0xkobold/pi-cursor","version":"0.1.0","description":"pi extension for Cursor AI agent via ACP protocol","type":"module","keywords":["pi-package"],"scripts":{"test":"echo \"Run 'pi --print' and test with @cursor_agent\""},"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/0xkobold/pi-cursor.git"},"bugs":{"url":"https://github.com/0xkobold/pi-cursor/issues"},"peerDependencies":{"@mariozechner/pi-coding-agent":"*","@sinclair/typebox":"*"},"pi":{"extensions":["./extensions"],"skills":["./skills"]},"_id":"@0xkobold/pi-cursor@0.1.0","gitHead":"ee84320c41cbddb38a9fb41ea27a1703dbb7cbff","homepage":"https://github.com/0xkobold/pi-cursor#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-kDhIDYjMBvfIaliEEeZPTOWXQM3f2ihOsbR+b+MaxX+6u103/4ObReU4lmZiId6F2+p7tq2ptEcAf5Y/b6Mo8A==","shasum":"31a5ac5e4fbb6014bc798f568c8ff5d29fa19742","tarball":"https://registry.npmjs.org/@0xkobold/pi-cursor/-/pi-cursor-0.1.0.tgz","fileCount":6,"unpackedSize":22612,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCjSYt0nri0mQV1tYG+KmnH8HWjN8wogkcF9dcp/Bm9GQIhAOz3ZEYUFjzLBBNf4tKoyKUvVGtrYz6wwZOGDjpyDjhN"}]},"_npmUser":{"name":"moikapy","email":"warrenckhan@gmail.com"},"directories":{},"maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-cursor_0.1.0_1774311445462_0.8609939207171424"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-24T00:17:25.352Z","0.1.0":"2026-03-24T00:17:25.605Z","modified":"2026-03-24T00:17:25.820Z"},"maintainers":[{"name":"moikapy","email":"warrenckhan@gmail.com"}],"description":"pi extension for Cursor AI agent via ACP protocol","homepage":"https://github.com/0xkobold/pi-cursor#readme","keywords":["pi-package"],"repository":{"type":"git","url":"git+https://github.com/0xkobold/pi-cursor.git"},"bugs":{"url":"https://github.com/0xkobold/pi-cursor/issues"},"license":"MIT","readme":"# pi-cursor\n\nCursor ACP extension for [pi](https://github.com/mariozechner/pi) - Use Cursor's AI agent via the Agent Client Protocol.\n\n## Features\n\n- **Delegate tasks to Cursor Agent** - Offload complex coding tasks with full tool access\n- **Multiple modes** - `agent` (full access), `plan` (read-only), `ask` (Q&A)\n- **Built-in tools** - `cursor_agent`, `cursor_status`, `cursor_disconnect`\n- **Commands** - `/cursor:connect`, `/cursor:mode`, `/cursor:help`, `/cursor:disconnect`\n- **Skill included** - Auto-detected by pi agents for guided usage\n\n## Prerequisites\n\n- [Cursor IDE](https://cursor.com) installed\n- [pi](https://github.com/mariozechner/pi) installed\n\n## Installation\n\n### Option 1: Clone & Symlink (Recommended for Development)\n\n```bash\ngit clone https://github.com/YOUR_USER/pi-cursor.git\ncd pi-cursor\npi install ./extensions\n```\n\n### Option 2: Direct Clone to Extensions Directory\n\n```bash\npi install https://github.com/YOUR_USER/pi-cursor.git\n```\n\n### Option 3: Manual Installation\n\n```bash\n# Install Cursor CLI\ncurl https://cursor.com/install -fsS | bash\n\n# Authenticate\nagent login\n\n# Create symlink\nmkdir -p ~/.pi/agent/extensions\nln -sf /path/to/pi-cursor/extensions/cursor-acp.ts ~/.pi/agent/extensions/cursor-acp.ts\n```\n\n## Setup Cursor CLI\n\n1. Install the Cursor Agent CLI:\n   ```bash\n   curl https://cursor.com/install -fsS | bash\n   ```\n\n2. Authenticate:\n   ```bash\n   agent login\n   ```\n\n3. Verify installation:\n   ```bash\n   agent --version\n   ```\n\n## Usage\n\n### Commands in pi\n\n```\n/cursor:connect     # Start Cursor Agent session\n/cursor:mode agent  # Switch to agent mode (default)\n/cursor:mode plan   # Switch to read-only planning mode\n/cursor:mode ask    # Switch to Q&A mode\n/cursor:disconnect  # End session\n/cursor:help        # Show help\n```\n\n### Tools\n\n#### `@cursor_agent(prompt, mode?)`\n\nDelegate a task to Cursor Agent.\n\n**Examples:**\n```\n@cursor_agent Write a README for this project\n\n@cursor_agent Plan: Analyze the codebase structure\n\n@cursor_agent Fix the bug in src/auth/login.ts\n```\n\n#### `cursor_status`\n\nCheck if Cursor CLI is installed and authenticated.\n\n#### `cursor_disconnect`\n\nEnd the Cursor Agent session.\n\n## How It Works\n\n```\npi → cursor-acp extension → agent acp (CLI process) → Cursor Cloud\n```\n\nThe extension spawns an `agent acp` child process and communicates via JSON-RPC over stdio.\n\n## Troubleshooting\n\n### \"Command not found: agent\"\n\nThe Cursor CLI isn't installed. Run:\n```bash\ncurl https://cursor.com/install -fsS | bash\n```\n\n### \"Authentication required\"\n\nRun `agent login` to authenticate with your Cursor account.\n\n### Extension not loading\n\nCheck that the symlink exists:\n```bash\nls -la ~/.pi/agent/extensions/cursor-acp.ts\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-586b1775caead8f1761c8eb5b1623210"}