skip to content
iii / worker
$worker

cursor

v0.1.5

Cursor as a login-backed, text-only LLM Router provider and coding-agent worker through official CLI ACP, with optional sdk.v1 Bridge sessions.

iiiverified
1 installs0 in 7d0 today
install
$iii trigger compose::add worker=cursor@0.1.5
bundlelicense: Apache-2.0acpbridgecloud-agentcoding-agentcursorllmlocal-agentprovider
14functions0triggers0skills4depsv0.1.5version
repoiii-hq/workers

exact versions are immutable; binary and bundle artifacts are digest-pinned.

functions

14

cursor::auth::status

function

Check whether the official Cursor Agent CLI can reuse an existing cursor-agent login. Account details and credentials are never returned.

request
empty object
response
  • authenticatedbooleanrequired
  • availablebooleanrequired
  • errorany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • login_commandstringrequired
  • statusstringrequiredenum: authenticated, partial, unauthenticated, unavailable
  • versionany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull

cursor::models::list

function

List the current account-scoped Cursor model catalog. Select sdk-bridge for the cloud/API-key catalog.

request
  • backendstringenum: cli-acp, sdk-bridge
response
  • modelsobject[]required
    • descriptionstringrequired
    • display_namestringrequired
    • idstringrequired
    • parametersobject[]required
      • display_namestringrequired
      • idstringrequired
      • valuesobject[]required
        … expand 2 nested
        • display_namestringrequired
        • valuestringrequired
    • variantsobject[]required
      • descriptionstringrequired
      • display_namestringrequired
      • is_defaultbooleanrequired
      • paramsobject[]required
        … expand 2 nested
        • idstringrequired
        • valuestringrequired

cursor::on-config-change

function

Internal Cursor configuration reload hook.

request
  • idstring
response
  • okbooleanrequired

cursor::run

function

Run one Cursor coding-agent turn and wait for its terminal result. Local runs default to the login-backed Cursor CLI ACP; cloud runs use the separately installed sdk.v1 Bridge. The ACP-compatible shape requires cwd and model.

request
any of (2)
variant 1
one of (2)
variant 1
  • cwdstringrequiredmin 1 chars
  • messagesobject[]
    … expand 2 nested
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringrequiredmin 1 chars
  • namestringmin 1 chars
  • promptstring
  • runtimestringrequired
  • session_idstringmin 1 chars
  • timeout_msintegermax 9007199254740991
  • toolsstring[]
variant 2
  • auto_create_prboolean
  • messagesobject[]
    … expand 2 nested
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringmin 1 chars
  • namestringmin 1 chars
  • promptstring
  • repositoriesobject[]
    … expand 3 nested
    • pr_urlstring· uri
    • starting_refstring
    • urlstringrequiredmin 1 chars
  • runtimestringrequired
  • session_idstringmin 1 chars
  • work_on_current_branchboolean
variant 2
  • cwdstringrequiredmin 1 chars
  • messagesobject[]
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringrequiredmin 1 chars
  • promptstring
  • providerstring
  • runtimeunknown
  • session_idstringmin 1 chars
  • system_promptstring
  • timeout_msintegermax 9007199254740991
response
  • agent_idany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • busybooleanrequired
  • costany ofrequired
    any of (2)
    variant 1
    • charged_centsnumberrequiredmin 0
    • raw_cost_centsnumberrequiredmin 0
    variant 2
    valuenull
  • errorany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • error_detailsany ofrequired
    any of (2)
    variant 1
    • rate_limitany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      • limitany ofrequired
        … expand 2 nested
        any of (2)
        variant 1
        valuestring
        variant 2
        valuenull
      • remainingany ofrequired
        … expand 2 nested
        any of (2)
        variant 1
        valuestring
        variant 2
        valuenull
      • reset_epoch_secondsany ofrequired
        … expand 2 nested
        any of (2)
        variant 1
        valuestring
        variant 2
        valuenull
      variant 2
      valuenull
    • request_idany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • retry_after_secondsany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuenumbermin 0
      variant 2
      valuenull
    • sdk_error_codeany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenumber
      variant 2
      valuenull
    • transport_codeany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    variant 2
    valuenull
  • is_errorbooleanrequired
  • recovery_requiredbooleanrequired
  • resultstringrequired
  • run_idany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • session_idstringrequired
  • statusstringrequired
  • stop_reasonany ofrequired
    any of (2)
    variant 1
    valuestringenum: end, length, aborted, error
    variant 2
    valuenull
  • usageany ofrequired
    any of (2)
    variant 1
    • cache_read_tokensintegerrequired0…9007199254740991
    • cache_write_tokensintegerrequired0…9007199254740991
    • input_tokensintegerrequired0…9007199254740991
    • output_tokensintegerrequired0…9007199254740991
    • reasoning_tokensinteger0…9007199254740991
    • total_tokensintegerrequired0…9007199254740991
    variant 2
    valuenull

cursor::sessions::list

function

List durable iii-to-Cursor session mappings owned by this worker.

request
empty object
response
  • sessionsobject[]required
    • active_run_idany ofrequired
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • active_turnany ofrequired
      any of (2)
      variant 1
      valueintegermax 9007199254740991
      variant 2
      valuenull
    • agent_createdbooleanrequired
    • agent_idstringrequired
    • auto_create_prbooleanrequired
    • backendstringenum: cli-acp, sdk-bridge
    • cancel_requestedbooleanrequired
    • claim_idany ofrequired
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • claim_started_at_msany ofrequired
      any of (2)
      variant 1
      valueinteger0…9007199254740991
      variant 2
      valuenull
    • costany ofrequired
      any of (2)
      variant 1
      • charged_centsnumberrequiredmin 0
      • raw_cost_centsnumberrequiredmin 0
      variant 2
      valuenull
    • create_idempotency_keystringrequired
    • last_run_idany ofrequired
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • modelstringrequired
    • nameany ofrequired
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • pending_prompt_sha256any ofrequired
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • repositoriesobject[]required
      • pr_urlstring· uri
      • starting_refstring
      • urlstringrequiredmin 1 chars
    • runtimestringrequiredenum: local, cloud
    • send_idempotency_keyany ofrequired
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • send_startedbooleanrequired
    • session_idstringrequired
    • statusstringrequiredenum: working, done, error, cancelled, recovery-required
    • toolsstring[]required
    • turnsintegerrequired0…9007199254740991
    • updated_at_msintegerrequired0…9007199254740991
    • usageany ofrequired
      any of (2)
      variant 1
      • cache_read_tokensintegerrequired0…9007199254740991
      • cache_write_tokensintegerrequired0…9007199254740991
      • input_tokensintegerrequired0…9007199254740991
      • output_tokensintegerrequired0…9007199254740991
      • reasoning_tokensinteger0…9007199254740991
      • total_tokensintegerrequired0…9007199254740991
      variant 2
      valuenull
    • work_on_current_branchbooleanrequired
    • workspacestringrequired

cursor::start

function

Start a Cursor agent turn and return immediately. Watch agent::events with group_id equal to session_id.

request
one of (2)
variant 1
  • cwdstringrequiredmin 1 chars
  • messagesobject[]
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringrequiredmin 1 chars
  • namestringmin 1 chars
  • promptstring
  • runtimestringrequired
  • session_idstringmin 1 chars
  • timeout_msintegermax 9007199254740991
  • toolsstring[]
variant 2
  • auto_create_prboolean
  • messagesobject[]
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringmin 1 chars
  • namestringmin 1 chars
  • promptstring
  • repositoriesobject[]
    • pr_urlstring· uri
    • starting_refstring
    • urlstringrequiredmin 1 chars
  • runtimestringrequired
  • session_idstringmin 1 chars
  • work_on_current_branchboolean
response
  • session_idstringrequired
  • startedbooleanrequired

cursor::status

function

Read durable local ACP or Bridge-reported status for a Cursor session.

request
  • session_idstringrequiredmin 1 chars
response
  • agentany ofrequired
    any of (2)
    variant 1
    • agent_idstringrequired
    • archivedbooleanrequired
    • created_atany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • cwdany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • last_modifiedany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • metadataobjectrequired
    • namestringrequired
    • repositoriesstring[]required
    • runtimeany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestringenum: local, cloud
      variant 2
      valuenull
    • statusstringrequired
    • summarystringrequired
    variant 2
    valuenull
  • livebooleanrequired
  • recordany ofrequired
    any of (2)
    variant 1
    • active_run_idany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • active_turnany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valueintegermax 9007199254740991
      variant 2
      valuenull
    • agent_createdbooleanrequired
    • agent_idstringrequired
    • auto_create_prbooleanrequired
    • backendstringenum: cli-acp, sdk-bridge
    • cancel_requestedbooleanrequired
    • claim_idany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • claim_started_at_msany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valueinteger0…9007199254740991
      variant 2
      valuenull
    • costany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      • charged_centsnumberrequiredmin 0
      • raw_cost_centsnumberrequiredmin 0
      variant 2
      valuenull
    • create_idempotency_keystringrequired
    • last_run_idany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • modelstringrequired
    • nameany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • pending_prompt_sha256any ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • repositoriesobject[]required
      … expand 3 nested
      • pr_urlstring· uri
      • starting_refstring
      • urlstringrequiredmin 1 chars
    • runtimestringrequiredenum: local, cloud
    • send_idempotency_keyany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • send_startedbooleanrequired
    • session_idstringrequired
    • statusstringrequiredenum: working, done, error, cancelled, recovery-required
    • toolsstring[]required
    • turnsintegerrequired0…9007199254740991
    • updated_at_msintegerrequired0…9007199254740991
    • usageany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      • cache_read_tokensintegerrequired0…9007199254740991
      • cache_write_tokensintegerrequired0…9007199254740991
      • input_tokensintegerrequired0…9007199254740991
      • output_tokensintegerrequired0…9007199254740991
      • reasoning_tokensinteger0…9007199254740991
      • total_tokensintegerrequired0…9007199254740991
      variant 2
      valuenull
    • work_on_current_branchbooleanrequired
    • workspacestringrequired
    variant 2
    valuenull
  • remote_errorany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • runany ofrequired
    any of (2)
    variant 1
    • agent_idstringrequired
    • created_atany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • duration_msany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valueinteger0…9007199254740991
      variant 2
      valuenull
    • modelstringrequired
    • resultstringrequired
    • run_idstringrequired
    • statusstringrequired
    • usageany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      • cache_read_tokensintegerrequired0…9007199254740991
      • cache_write_tokensintegerrequired0…9007199254740991
      • input_tokensintegerrequired0…9007199254740991
      • output_tokensintegerrequired0…9007199254740991
      • reasoning_tokensinteger0…9007199254740991
      • total_tokensintegerrequired0…9007199254740991
      variant 2
      valuenull
    variant 2
    valuenull
  • session_idstringrequired

cursor::stop

function

Request cancellation of the active Cursor run for a session.

request
  • session_idstringrequiredmin 1 chars
response
  • reasonany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • session_idstringrequired
  • stoppedbooleanrequired

cursor::usage

function

Read Bridge-reported token usage and optional billed cost for a cloud Cursor session.

request
  • run_idstringmin 1 chars
  • session_idstringrequiredmin 1 chars
response
  • agent_idstringrequired
  • session_idstringrequired
  • usageobjectrequired
    • costany ofrequired
      any of (2)
      variant 1
      • charged_centsnumberrequiredmin 0
      • raw_cost_centsnumberrequiredmin 0
      variant 2
      valuenull
    • runsobject[]required
      • costany ofrequired
        … expand 2 nested
        any of (2)
        variant 1
        • charged_centsnumberrequiredmin 0
        • raw_cost_centsnumberrequiredmin 0
        variant 2
        valuenull
      • run_idstringrequired
      • usageobjectrequired
        … expand 6 nested
        • cache_read_tokensintegerrequired0…9007199254740991
        • cache_write_tokensintegerrequired0…9007199254740991
        • input_tokensintegerrequired0…9007199254740991
        • output_tokensintegerrequired0…9007199254740991
        • reasoning_tokensinteger0…9007199254740991
        • total_tokensintegerrequired0…9007199254740991
    • usageany ofrequired
      any of (2)
      variant 1
      • cache_read_tokensintegerrequired0…9007199254740991
      • cache_write_tokensintegerrequired0…9007199254740991
      • input_tokensintegerrequired0…9007199254740991
      • output_tokensintegerrequired0…9007199254740991
      • reasoning_tokensinteger0…9007199254740991
      • total_tokensintegerrequired0…9007199254740991
      variant 2
      valuenull

provider::cursor::abort

function

Cancel an in-flight Cursor ACP provider request.

request
  • request_idstringrequired
response
  • abortedbooleanrequired

provider::cursor::on_router_ready

function

Re-register the Cursor provider after an LLM Router restart.

request
empty object
response
  • okbooleanrequired

provider::cursor::refresh_models

function

Refresh the login-backed Cursor model catalog and replace its LLM Router slice.

request
empty object
response
  • countintegerrequired0…9007199254740991
  • okbooleanrequired

provider::cursor::stream

function

Stream a text-only Cursor completion through the official login-backed Cursor Agent ACP.

request
  • max_output_tokensintegermax 9007199254740991
  • messagesobject[]required
    empty object
  • modelstringrequiredmin 1 chars
  • model_metaunknown
  • provider_optionsunknown
  • resolution_keystring
  • response_formatobject
  • session_idstring
  • system_promptstring
  • thinking_levelstring
  • toolsunknown[]
  • writer_refobjectrequired
    • access_keystringrequired
    • channel_idstringrequired
    • directionstringrequired
response
  • okbooleanrequired

run::start_and_wait

function

Standard agent alias for cursor::run. Configure ACP with --brain-fn cursor::run when more than one agent worker is installed.

request
any of (2)
variant 1
one of (2)
variant 1
  • cwdstringrequiredmin 1 chars
  • messagesobject[]
    … expand 2 nested
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringrequiredmin 1 chars
  • namestringmin 1 chars
  • promptstring
  • runtimestringrequired
  • session_idstringmin 1 chars
  • timeout_msintegermax 9007199254740991
  • toolsstring[]
variant 2
  • auto_create_prboolean
  • messagesobject[]
    … expand 2 nested
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringmin 1 chars
  • namestringmin 1 chars
  • promptstring
  • repositoriesobject[]
    … expand 3 nested
    • pr_urlstring· uri
    • starting_refstring
    • urlstringrequiredmin 1 chars
  • runtimestringrequired
  • session_idstringmin 1 chars
  • work_on_current_branchboolean
variant 2
  • cwdstringrequiredmin 1 chars
  • messagesobject[]
    • contentany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      itemsobject[]
      • typestringrequired
    • rolestringrequired
  • modelstringrequiredmin 1 chars
  • promptstring
  • providerstring
  • runtimeunknown
  • session_idstringmin 1 chars
  • system_promptstring
  • timeout_msintegermax 9007199254740991
response
  • agent_idany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • busybooleanrequired
  • costany ofrequired
    any of (2)
    variant 1
    • charged_centsnumberrequiredmin 0
    • raw_cost_centsnumberrequiredmin 0
    variant 2
    valuenull
  • errorany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • error_detailsany ofrequired
    any of (2)
    variant 1
    • rate_limitany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      • limitany ofrequired
        … expand 2 nested
        any of (2)
        variant 1
        valuestring
        variant 2
        valuenull
      • remainingany ofrequired
        … expand 2 nested
        any of (2)
        variant 1
        valuestring
        variant 2
        valuenull
      • reset_epoch_secondsany ofrequired
        … expand 2 nested
        any of (2)
        variant 1
        valuestring
        variant 2
        valuenull
      variant 2
      valuenull
    • request_idany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    • retry_after_secondsany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuenumbermin 0
      variant 2
      valuenull
    • sdk_error_codeany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenumber
      variant 2
      valuenull
    • transport_codeany ofrequired
      … expand 2 nested
      any of (2)
      variant 1
      valuestring
      variant 2
      valuenull
    variant 2
    valuenull
  • is_errorbooleanrequired
  • recovery_requiredbooleanrequired
  • resultstringrequired
  • run_idany ofrequired
    any of (2)
    variant 1
    valuestring
    variant 2
    valuenull
  • session_idstringrequired
  • statusstringrequired
  • stop_reasonany ofrequired
    any of (2)
    variant 1
    valuestringenum: end, length, aborted, error
    variant 2
    valuenull
  • usageany ofrequired
    any of (2)
    variant 1
    • cache_read_tokensintegerrequired0…9007199254740991
    • cache_write_tokensintegerrequired0…9007199254740991
    • input_tokensintegerrequired0…9007199254740991
    • output_tokensintegerrequired0…9007199254740991
    • reasoning_tokensinteger0…9007199254740991
    • total_tokensintegerrequired0…9007199254740991
    variant 2
    valuenull

triggers

0
no triggers registered