KosmoKrator

other

Cursor Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Cursor KosmoKrator integration.

4 functions 4 read 0 write API key auth
Submit Cursor feedback View package source

Lua Namespace

Agents call this integration through app.integrations.cursor.*. Use lua_read_doc("integrations.cursor") inside KosmoKrator to discover the same reference at runtime.

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Cursor — Lua API Reference

list_workspaces

List all Cursor workspaces accessible to the authenticated user.

Parameters

This tool takes no parameters.

Examples

local result = app.integrations.cursor.list_workspaces({})

for _, workspace in ipairs(result) do
  print(workspace.id .. ": " .. workspace.name)
end

get_workspace

Get details for a specific Cursor workspace.

Parameters

NameTypeRequiredDescription
workspace_idstringyesThe workspace identifier

Examples

local result = app.integrations.cursor.get_workspace({
  workspace_id = "ws_abc123"
})

print("Workspace: " .. result.name)
print("ID: " .. result.id)

list_team_members

List all team members in a Cursor workspace.

Parameters

NameTypeRequiredDescription
workspace_idstringyesThe workspace identifier

Examples

local result = app.integrations.cursor.list_team_members({
  workspace_id = "ws_abc123"
})

for _, member in ipairs(result) do
  print(member.name .. " (" .. member.email .. ") — " .. member.role)
end

list_extensions

List all extensions installed in a Cursor workspace.

Parameters

NameTypeRequiredDescription
workspace_idstringyesThe workspace identifier

Examples

local result = app.integrations.cursor.list_extensions({
  workspace_id = "ws_abc123"
})

for _, ext in ipairs(result) do
  print(ext.identifier .. " v" .. ext.version)
end

Multi-Account Usage

If you have multiple Cursor accounts configured, use account-specific namespaces:

-- Default account (always works)
app.integrations.cursor.list_workspaces({})

-- Explicit default (portable across setups)
app.integrations.cursor.default.list_workspaces({})

-- Named accounts
app.integrations.cursor.work.list_workspaces({})
app.integrations.cursor.personal.list_workspaces({})

All functions are identical across accounts — only the credentials differ.

Raw agent markdown 
# Cursor — Lua API Reference

## list_workspaces

List all Cursor workspaces accessible to the authenticated user.

### Parameters

This tool takes no parameters.

### Examples

```lua
local result = app.integrations.cursor.list_workspaces({})

for _, workspace in ipairs(result) do
  print(workspace.id .. ": " .. workspace.name)
end
```

---

## get_workspace

Get details for a specific Cursor workspace.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace_id` | string | yes | The workspace identifier |

### Examples

```lua
local result = app.integrations.cursor.get_workspace({
  workspace_id = "ws_abc123"
})

print("Workspace: " .. result.name)
print("ID: " .. result.id)
```

---

## list_team_members

List all team members in a Cursor workspace.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace_id` | string | yes | The workspace identifier |

### Examples

```lua
local result = app.integrations.cursor.list_team_members({
  workspace_id = "ws_abc123"
})

for _, member in ipairs(result) do
  print(member.name .. " (" .. member.email .. ") — " .. member.role)
end
```

---

## list_extensions

List all extensions installed in a Cursor workspace.

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `workspace_id` | string | yes | The workspace identifier |

### Examples

```lua
local result = app.integrations.cursor.list_extensions({
  workspace_id = "ws_abc123"
})

for _, ext in ipairs(result) do
  print(ext.identifier .. " v" .. ext.version)
end
```

---

## Multi-Account Usage

If you have multiple Cursor accounts configured, use account-specific namespaces:

```lua
-- Default account (always works)
app.integrations.cursor.list_workspaces({})

-- Explicit default (portable across setups)
app.integrations.cursor.default.list_workspaces({})

-- Named accounts
app.integrations.cursor.work.list_workspaces({})
app.integrations.cursor.personal.list_workspaces({})
```

All functions are identical across accounts — only the credentials differ.

Metadata-Derived Lua Example

local result = app.integrations.cursor.cursor_list_workspaces({})
print(result)

Functions

cursor_list_workspaces

List all Cursor workspaces accessible to the authenticated user. Returns workspace IDs you can use with other Cursor tools.

Operation
Read read
Full name
cursor.cursor_list_workspaces
ParameterTypeRequiredDescription
No parameters.

cursor_get_workspace

Get details for a specific Cursor workspace by its ID.

Operation
Read read
Full name
cursor.cursor_get_workspace
ParameterTypeRequiredDescription
workspace_id string yes The workspace identifier.

cursor_list_team_members

List all team members in a Cursor workspace. Returns member names, emails, and roles.

Operation
Read read
Full name
cursor.cursor_list_team_members
ParameterTypeRequiredDescription
workspace_id string yes The workspace identifier.

cursor_list_extensions

List all extensions installed in a Cursor workspace. Returns extension names, identifiers, and versions.

Operation
Read read
Full name
cursor.cursor_list_extensions
ParameterTypeRequiredDescription
workspace_id string yes The workspace identifier.