Report Abuse

Basic Information

Cursor Agent Tools is a Python library that implements an AI coding assistant inspired by Cursor. It provides a packaged agent and tooling to generate, edit, analyze, and interact with code using remote models like Anthropic Claude and OpenAI as well as locally hosted Ollama models. The repository includes an agent factory, model-specific agent classes, a permission system for safe file and command operations, interactive mode for multi-step tasks, and a suite of built-in tools for file operations, searches, image queries, and running terminal commands. The project ships examples, tests, and documentation to help developers create custom agents, register tools, and integrate project context such as open files and cursor position. It is intended for developers who want a project-aware conversational coding assistant or a programmable agent that can operate on a local codebase while calling external models.

Links

Categorization

App Details

Features
The README documents core abilities and a wide toolset. Model flexibility supports Claude, OpenAI, and Ollama local models. Code generation, code editing, and code analysis features let the agent produce and modify files and review code. Function calling enables the agent to invoke registered Python tools. Built-in tools include read_file, edit_file with full or line-based edits, create_file, delete_file, list_dir, semantic codebase_search, grep_search, file_search, web_search, trend_search, query_images for LLM vision, and run_terminal_cmd. A permission system enforces secure defaults with YOLO mode, allowlists and denylists, and file deletion protection. Interactive mode supports automatic continuation with automatic user input detection and tool call limits to prevent runaway changes. The package includes examples, API docstrings, and configuration templates.
Use Cases
This project helps developers automate coding tasks and build project-aware conversational assistants. It accelerates common workflows like creating functions, fixing bugs, and refactoring by combining model-based code generation with precise file operations and semantic search. The permission system reduces risk by requiring approvals for destructive or system commands while allowing configurable automatic approvals for trusted environments. Custom tool registration and API integration examples make it straightforward to extend the agent with database queries, web APIs, or data processing routines. Interactive mode and project context passing let the agent operate across multiple iterations and incorporate open files and cursor position. Support for local Ollama models enables on-premise use when external APIs are undesired. The package includes installation instructions, examples, and configuration guidance to get started with Python 3.8+ and required API keys.

Please fill the required fields*