List Items
Follow the item-operations skill (${CLAUDE_PLUGIN_ROOT}/skills/item-operations/SKILL.md) for the query syntax, filters and batch rules; read it before the first call.
Arguments
collection(required) — Collection name--filter <field=value>— Filter by field value (e.g.,--filter status=published)--sort <field>— Sort field (prefix-for descending, e.g.,--sort -date_created)--limit <n>— Max results (default: 25)
Process
- Parse arguments from the input
- Call
schematool withkeys: ["<collection>"]to understand fields - Build query object:
- Select the most useful fields based on schema (avoid fetching all fields on wide collections)
- Apply filter if provided:
{ "<field>": { "_eq": "<value>" } } - Apply sort if provided
- Apply limit (default 25)
- Call
itemstool withaction: "read",collection, andquery - Display results as a formatted table
- Show total count if available
Example
Input: posts --filter status=published --sort -date_created --limit 10
{
"action": "read",
"collection": "posts",
"query": {
"fields": ["id", "title", "status", "date_created"],
"filter": { "status": { "_eq": "published" } },
"sort": ["-date_created"],
"limit": 10
}
}