data
KeystoneJS CLI for Headless Automation
Use the KeystoneJS CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write Bearer token auth
KeystoneJS CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The KeystoneJS CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# KeystoneJS CLI for Headless Automation
kosmokrator integrations:configure keystone --set access_token="$KEYSTONE_ACCESS_TOKEN" --set url="$KEYSTONE_URL" --enable --read allow --write ask --json
kosmo integrations:call keystone.keystone_list_lists '{}' --json Discovery Before Execution
Agents and scripts can inspect KeystoneJS docs and schemas before choosing a function.
kosmo integrations:docs keystone --json
kosmo integrations:docs keystone.keystone_list_lists --json
kosmo integrations:schema keystone.keystone_list_lists --json
kosmo integrations:search "KeystoneJS" --json
kosmo integrations:list --json Useful KeystoneJS CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
keystone.keystone_list_lists | Read | none | List all available lists (collections) in the KeystoneJS instance. Returns list keys, labels, and metadata. |
keystone.keystone_get_list | Read | list_key | Get metadata and field schema for a specific KeystoneJS list. Returns field definitions, access control, and display configuration. |
keystone.keystone_list_items | Read | list_key, take, skip, sort, where, search, fields | List items in a KeystoneJS list with optional filtering, sorting, and pagination. Returns an array of items from the specified list. |
keystone.keystone_get_item | Read | list_key, id, fields | Retrieve a single item from a KeystoneJS list by its ID. |
keystone.keystone_create_item | Write | list_key, data | Create a new item in a KeystoneJS list with the provided field values. |
keystone.keystone_list_users | Read | take, skip, sort, where, search, fields | List users in the KeystoneJS instance with optional filtering, sorting, and pagination. |
keystone.keystone_get_current_user | Read | fields | Get the profile of the currently authenticated KeystoneJS user. Useful for verifying the connection and understanding user permissions. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.