Cursor Integration

Cursor is an AI-powered code editor built on VS Code that integrates large language models directly into the development workflow. Plexus can monitor your Cursor sessions, tracking AI interactions, token usage, and costs across all your projects.

What is Cursor?

Cursor is a modern code editor designed for AI-assisted development. Key features include:

• Composer - Cursor's flagship AI model for multi-file code generation and refactoring
• Tab Completion - Intelligent inline code suggestions powered by AI
• Chat - Interactive AI assistant for code explanations and help
• Agent Mode - Autonomous coding capabilities with tool access (terminal, file operations)
• MCP Support - Model Context Protocol integration for external tools and data sources

Cursor 2.0 introduced significant improvements including parallel agent execution (up to 8 agents), an in-app browser, and voice input capabilities.

How Plexus Integrates with Cursor

Plexus monitors Cursor through its hook system, capturing AI interactions in real-time:

┌─────────────────────────────────────────────────┐
│                   Cursor IDE                     │
│                                                 │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │ Composer │  │   Chat   │  │   Tab    │      │
│  │          │  │          │  │ Complete │      │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘      │
│       │             │             │             │
│       └─────────────┼─────────────┘             │
│                     ▼                           │
│  ┌──────────────────────────────────────────┐  │
│  │           Plexus Hook Layer              │  │
│  └──────────────────────────────────────────┘  │
│                     │                           │
└─────────────────────┼───────────────────────────┘
                      ▼
              ┌───────────────┐
              │    Plexus     │
              │   Dashboard   │
              └───────────────┘

Monitored Features

Setting Up the Integration

Automatic Setup

When you first launch Plexus with Cursor installed, the integration is configured automatically:

1. Launch Plexus from your Applications folder
2. Plexus detects Cursor and installs the necessary hooks
3. Open Cursor and start coding - sessions will appear in Plexus

Manual Setup

If automatic setup doesn't work, you can configure the integration manually:

1. Open Plexus and go to Settings > Agents
2. Find Cursor in the list and click Configure
3. Follow the on-screen instructions

Verifying the Integration

To verify Plexus is connected to Cursor:

1. Open Cursor and start a new project
2. Use any AI feature (Composer, Chat, or Tab completion)
3. Check the Plexus dashboard - a new Cursor session should appear

Cursor Configuration Files

Plexus integrates with Cursor's configuration system. Here are the key locations:

Cursor Rules

Cursor supports project-specific rules that customize AI behavior:

• Project Rules: .cursor/rules/*.mdc files in your project root
• User Rules: Global rules in Cursor Settings > Rules > User Rules

Plexus respects these rules and displays which rules are active for each session.

Monitoring AI Features

Composer Sessions

When you use Composer for multi-file edits, Plexus tracks:

• Files being modified
• Token usage per request
• Generation time
• Success/failure status

In the Plexus dashboard, Composer sessions show:

• A "Composer" badge on the session card
• Multi-file change summaries
• Estimated cost for the operation

Chat Interactions

Plexus monitors Chat interactions including:

• Question and response pairs
• Code snippets shared
• Token counts for input and output

Agent Mode

When Cursor runs in Agent Mode, Plexus provides enhanced monitoring:

• Tool invocations (terminal, file operations)
• Execution steps and decisions
• Error states and recovery attempts

Agent sessions are marked with an "Agent" badge in the dashboard.

Cost Tracking

Plexus tracks API costs for Cursor sessions:

Note: Cursor Pro includes a monthly credit pool. Plexus shows usage against this pool when detected.

Viewing Cost Breakdown

1. Click on a Cursor session in the dashboard
2. Select the Costs tab
3. View token usage by interaction type

MCP Integration Monitoring

If you've configured MCP (Model Context Protocol) servers in Cursor, Plexus can monitor these connections:

What Plexus Tracks

• Active MCP server connections
• Tool calls made through MCP
• Data retrieved from external sources

MCP Configuration Location

Cursor stores MCP configuration in:

~/.cursor/mcp.json

Troubleshooting

Cursor Sessions Not Appearing

If Cursor sessions don't appear in Plexus:

1. Verify Plexus is running - Check your system tray/menu bar
2. Restart Cursor - Close and reopen the IDE
3. Check hook installation - Go to Plexus Settings > Agents > Cursor
4. Reinstall hooks - Click "Reinstall" in the Cursor agent settings

Delayed Updates

If session updates are delayed:

1. Check that both Plexus and Cursor have file system access
2. Verify no firewall is blocking local socket communication
3. Restart both applications

Cost Tracking Inaccurate

If costs don't match your expectations:

1. Ensure you've selected the correct model in Plexus settings
2. Check that Cursor is sending token counts (some models may not report)
3. Verify your Cursor subscription tier in Settings

Agent Mode Not Detected

If Agent Mode sessions aren't being tracked:

1. Ensure you're using Cursor 2.0 or later
2. Check that Plexus hooks are up to date
3. Reinstall hooks from Plexus Settings

MCP Connections Not Showing

If MCP server connections aren't visible:

1. Verify MCP is properly configured in ~/.cursor/mcp.json
2. Restart Cursor after configuring MCP
3. Check Plexus logs for connection errors

Best Practices

Optimize Token Usage

1. Use Tab completion for small edits (lower token cost)
2. Reserve Composer for multi-file operations
3. Be specific in Chat prompts to reduce back-and-forth

Manage Multiple Projects

1. Plexus automatically groups sessions by project
2. Use the project filter in the dashboard sidebar
3. Set up notifications for projects that need attention

Team Workflows

For teams using Cursor:

1. Configure Slack/Discord notifications for agent waiting states
2. Use the History feature to review past AI interactions
3. Track costs by project for budget management

Next Steps

• Learn about Webhook Notifications for team alerts
• Explore Keyboard Shortcuts for faster navigation
• Check Configuration Options for advanced settings