Cursor Observe

LLM command monitoring and debugging that integrates with the Cursor CLI, reading your terminal in realtime.

Installation

# Install with uv (recommended)
uv pip install -e .

# Or install with pip
pip install -e .

Usage

Simply wrap any command with observe:

Example

Run them with observe to get AI-powered monitoring. For example:

uv run observe python tests/train_mnist.py

The observe wrapper will:

1. Monitor the command output in real-time
2. Detect potential issues (overfitting, errors, performance problems)
3. Suggest fixes using the Cursor CLI
4. Help debug and optimize your code

Requirements

• Python 3.8+
• OpenAI API key (set as OPENAI_API_KEY environment variable)
• Cursor CLI installed
• GPU recommended for ML examples