Skip to content

Latest commit

 

History

History
152 lines (117 loc) · 5.42 KB

README.md

File metadata and controls

152 lines (117 loc) · 5.42 KB

Cursor-Utils

Give your Cursor Agent superpowers.

PyPI Downloads

Read our docs

Asking Perplexity to perform ai guided web research

image
see what happens next... image


Asking Gemini for a plan

see what happens next... image
see what happens next... image


Performing repository analysis

image
see what happens next... image


Installation

pip install cursor-utils

using uv:

uv pip install cursor-utils

using poetry:

poetry add cursor-utils

using pipx:

pipx install cursor-utils

Read our docs

Cursor is already an amazing tool for developers. Cursor-Utils extends your existing agents with new skills and advanced features via:

  • Google's Gemini: Leverage Gemini's 2M token context window for ENTIRE codebase contextual memory, grounding & reasoning.
  • Perplexity: Enabling your Cursor Agents to access real-time web information without the risk of hallucinations.
  • Local & Remote Repository Analysis: Providing sophisticated project analysis tools.
  • Code Generation: Offering advanced code generation capabilities via Google's Gemini.
  • Documentation Generation: Providing sophisticated project analysis tools.
  • GitHub Management: Streamlining GitHub interactions and repository management.

All this functionality is exposed through a clean, intuitive CLI that your Cursor Agents can use directly.

Getting Started

To get started with Cursor-Utils, follow these steps:

[!NOTE] We designed cursor-utils to be used by Cursor Agents. Therefore there's really nothing else you need to do besides configuring the api keys.

However if you want to explore the available commands and their options, you can do so. [!NOTE]

  1. Read the installation guide to set up Cursor-Utils
  2. Explore the usage documentation for detailed usage patterns
  3. Learn about configuration options to customize your experience

Why Cursor-Utils?

Our Benchmarks speak for themselves. Extensive benchmarking and profiling reflect:

  • an 87.8% increase in Cursor Agent Accuracy, Correctness, and Quality of answers using only Zero Shot Prompting & Cursor-Utils.

  • a 98.2% increase in developer workflow productivity using only Cursor IDE & Cursor-Utils.

Cursor-Utils addresses common challenges in the development workflow:

  • Reducing Context Switching: Get answers directly in your terminal without switching to a browser
  • Accelerating Onboarding: Quickly understand new codebases with AI-powered analysis
  • Streamlining Research: Find relevant information faster with intelligent web search
  • Enhancing Productivity: Automate documentation, code generation, and GitHub tasks
  • Improving Collaboration: Share standardized insights and documentation with team members

Example Workflow

Simply ask your Cursor Agent to:

# Analyze a new codebase you're working with
Use cursor-utils repo https://github.com/organization/project "Explain the authentication system"
# Research a technical concept
Ask Perplexity about "Best practices for GraphQL error handling"
# Generate a code snippet for your current project
Ask Gemini to "Write a Python function to validate JWT tokens"
# Create an issue based on your findings
Use cursor-utils github to create-issue --owner your-org --repo your-repo --title "Improve JWT validation"

Community and Support