cursor-agent

# Cursor Agent Tools

![License](https://img.shields.io/github/license/civai-technologies/cursor-agent)
![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
![Anthropic](https://img.shields.io/badge/Anthropic-Cursor-blueviolet)
![OpenAI](https://img.shields.io/badge/OpenAI-GPT4-green)
![Ollama](https://img.shields.io/badge/Ollama-Local%20Models-orange)

A Python-based AI agent that replicates Cursor's coding assistant capabilities, enabling function calling, code generation, and intelligent coding assistance with Cursor, OpenAI, and locally hosted Ollama models.

## 🌟 Features

This AI Agent implementation provides a comprehensive set of capabilities:

### Core Abilities

- **Model Flexibility**: Works with Cursor (Anthropic), OpenAI models, and locally hosted Ollama models
- **Code Generation**: Generate complete, functional code based on natural language descriptions
- **Code Editing**: Make precise edits to existing code files
- **Code Analysis**: Review and analyze code for bugs, improvements, and optimizations
- **Function Calling**: Invoke registered tools and functions based on user requests
- **Conversational Context**: Maintain a conversation history for coherent back-and-forth interactions
- **Project-Aware Responses**: Consider project context when answering questions
- **Permission System**: Secure permission handling for file operations and command execution
- **Local Model Support**: Use open-source models hosted locally with Ollama

### Tool Functions

The agent supports a comprehensive set of tools:

- **File Operations**:
  - **read_file**: Read file contents with flexible line range control
  - **edit_file**: Make precise edits to files with clear instructions
    - Supports complete file replacement
    - Supports line-based editing with JSON dictionaries (e.g., `{"1-5": "new content", "10-12": "more content"}`)
  - **delete_file**: Remove files from the filesystem
  - **create_file**: Create new files with specified content
  - **l