optio-cursor
Run Cursor CLI (cursor-agent) as an optio task — either as a local
subprocess or on a remote host over SSH — with the interactive TUI
embedded in the optio dashboard via an iframe widget served by ttyd.
Install
pip install optio-cursor
Requires Python 3.11+. Pulls optio-core, optio-host, optio-agents,
asyncssh, and aiohttp.
What it does
Cursor CLI is a near-twin of Grok Build / Claude Code. optio-cursor
adapts the optio-grok machinery: it launches cursor-agent inside a
detached tmux session, serves the TUI over ttyd, and coordinates with
the host harness through the optio.log keyword channel (STATUS /
DELIVERABLE / DONE / ERROR). The agent reads its task from an
AGENTS.md file planted in the workdir.
Isolation
Each task runs under an isolated HOME (<workdir>/home) with the XDG
base dirs (XDG_CONFIG_HOME, XDG_CACHE_HOME, XDG_DATA_HOME) pinned
under it, so cursor's ~/.cursor and ~/.cache state never touches the
operator's real home. Permission rules are config-planted (cursor has no
--allow/--deny argv): they go into <home>/.cursor/cli-config.json.
At login cursor spawns xdg-open for the auth URL; the redirect
browser-shim (front of PATH) captures it and surfaces the URL to the
operator on a BROWSER: line instead of a browser popping on the host.
Status
Stage 0 (MVP): iframe/ttyd mode, local host. Resume, seeds, conversation mode, and filesystem isolation arrive in later stages.
Metadata
Release files for optio-cursor 0.4.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| optio_cursor-0.4.7.tar.gz | 132.7 kB | Without provenance | Details for optio_cursor-0.4.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| optio_cursor-0.4.7-py3-none-any.whl | Python 3 | none | any | Details for optio_cursor-0.4.7-py3-none-any.whl |
Total release size: 216.8 kB
Release files / optio_cursor-0.4.7.tar.gz
| Download URL | optio_cursor-0.4.7.tar.gz |
|---|---|
| Size | 132.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5bb41891965c98a3f6248130dfb70d69fc219077efa389a4d138ed43dceb327c
|
|
BLAKE2b-256 checksum How to use checksums |
b31d1c007d3705668c03f169bbb276e544842e1c7c16f64c7f01e5c2d32f7c9f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / optio_cursor-0.4.7-py3-none-any.whl
| Download URL | optio_cursor-0.4.7-py3-none-any.whl |
|---|---|
| Size | 84.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
979d7436b21b1b90c0dc7252a512b7a22899655e6bf8f9aeda291bc4eddea44b
|
|
BLAKE2b-256 checksum How to use checksums |
96eff4cbbbb366d264f4cfd3b7ba44cb1574bc7c858dc321be1f1149e91baaca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Security for optio-cursor 0.4.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.