Metadata-Version: 2.1
Name: cursor-sdk
Version: 1.0.25
Summary: Python client for the Cursor SDK bridge.
Author: Cursor
License: Proprietary
Project-URL: Homepage, https://cursor.com
Project-URL: Documentation, https://cursor.com/docs/sdk/python
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: httpx <1,>=0.27
Provides-Extra: test
Requires-Dist: packaging >=24 ; extra == 'test'
Requires-Dist: pytest-asyncio >=0.23 ; extra == 'test'
Requires-Dist: pytest >=8 ; extra == 'test'

# cursor-sdk

Python SDK for Cursor agents — script the same agent that runs in the Cursor IDE, CLI, and web app, with sync and async clients.

Docs and quickstart: https://cursor.com/docs/sdk/python

## Shared SDK version

Starting with `1.0.24`, the Python package and `@cursor/sdk` use the same
version and are built from the same commit. Python therefore jumps directly
from `0.1.9` to `1.0.24`; there are no missing Python releases in between.
The alignment does not change the Python SDK's public-beta status.

## Install

```bash
pip install cursor-sdk
```

Requires Python 3.10+. Wheels are published for macOS (arm64, x64), Linux (arm64, x64), and Windows (x64).

For cloud agents, `agent.get_usage()` returns billed token usage and dollar
cost per run. Cost is server-derived from Cursor's billing pipeline
(discounts included, never estimated client-side) and eventually consistent
shortly after a run ends. Local agents are not supported yet.

> Public beta. APIs may change before general availability.
