@konductro/cursor-plugin
v1.0.0
Published
Cursor IDE plugin for the Konductro platform: technical analysis, delivery tasks, repository profiling, and prototype workflows.
Downloads
106
Maintainers
Readme
@konductro/cursor-plugin
Cursor IDE plugin for the Konductro delivery platform. Enables technical analysis, story decomposition, ticket management, prototype delivery, and ticket-to-PR workflows directly from Cursor.
Prerequisites
- Node.js 18+
- Cursor IDE (any plan — MCP works on free tier)
- Konductro CLI token (generated in Konductro → Settings → CLI Access)
Install
npm install -g @konductro/cursor-pluginSetup
konductro-cursor-setup --url https://platform.konductro.com --token YOUR_CLI_TOKENThis will:
- Configure the Konductro MCP server in
~/.cursor/mcp.json - Install Cursor Rules to
~/.cursor/rules/
After setup, reload Cursor (Cmd+Shift+P → "Developer: Reload Window").
Options
| Flag | Description | Default |
|------|-------------|---------|
| --url | Konductro platform URL | Required |
| --token | Your personal CLI token | Required |
| --project | Install to .cursor/ in current directory instead of global | false |
| --env-refs | Use ${env:...} references instead of inline values (for git-committed configs) | false |
Rules (Workflows)
Rules are guided workflows that Cursor invokes based on context:
| Rule | Description |
|------|-------------|
| start-ticket | Pick up a Konductro ticket, create branch, and start work |
| decompose | Decompose a story into technical implementation tasks |
| technical-analysis | Perform a technical analysis for a project phase |
| profile-repository | Scan repository and submit its tech profile |
| prototype | Build a UX prototype and publish to S3 |
| find-prototype | Find and download approved prototypes |
| bug-enrich | Enrich a bug report with codebase context |
MCP Tools
Tools are called automatically by Cursor's agent based on your requests:
| Tool | What it does |
|------|-------------|
| list_my_tickets | List all tickets assigned to you |
| get_ticket_context | Load full context for a ticket |
| start_work | Create branch and start a ticket |
| create_pr | Create a pull request for a ticket |
| list_tech_analysis_tasks | List tech analysis assignments |
| get_task_context | Load tech analysis context |
| submit_tech_analysis | Submit analysis document |
| list_decomposition_tasks | List story decomposition assignments |
| get_decomposition_context | Load story context |
| submit_decomposition_task | Submit a decomposed task |
| complete_decomposition | Mark decomposition complete |
| list_prototype_tasks | List prototype assignments |
| get_prototype_context | Load prototype context |
| start_prototype_work | Mark prototype in progress |
| request_upload_credentials | Get S3 upload credentials |
| submit_prototype | Submit completed prototype |
| profile_repository | Submit repository profile |
| find_project_prototypes | Find UX prototypes for a project |
Updating Your Token
Run the setup command again with the new token:
konductro-cursor-setup --url https://platform.konductro.com --token NEW_TOKENTroubleshooting
- MCP server not connecting: Reload Cursor after config changes (Cmd+Shift+P → "Developer: Reload Window")
- Tools not showing: Check Cursor Settings → MCP tab for connection status and errors
- Rules not activating: Ensure rules are in
~/.cursor/rules/or.cursor/rules/and mention Konductro in your prompt
