create_list
Create named lists of files, URLs, or items for parallel processing operations across multiple elements in a single workflow.
Instructions
Creates a named list of items for parallel processing. Use this tool when you need to perform the same operation across multiple files, URLs, or any collection of items.
WHEN TO USE:
Before running shell commands or AI agents across multiple items
When you have a collection of file paths, URLs, identifiers, or any strings to process in parallel
WORKFLOW:
Call create_list with your array of items
Use the returned list_id with run_shell_across_list or run_agent_across_list
The list persists for the duration of the session
EXAMPLE: To process files ["src/a.ts", "src/b.ts", "src/c.ts"], first create a list, then use run_shell_across_list or run_agent_across_list with the returned id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Array of items to store in the list. Each item can be a file path, URL, identifier, or any string that will be substituted into commands or prompts. |
Implementation Reference
- src/index.ts:171-182 (handler)The handler function for the 'create_list' tool. It generates a unique list ID using generateListId(), stores the provided items in the global 'lists' Map, and returns a success message with the list ID.
async ({ items }) => { const id = generateListId(); lists.set(id, items); return { content: [ { type: "text", text: `Successfully created a list with ${items.length} items. The list ID is "${id}". You can now use this ID with run_shell_across_list or run_agent_across_list to process each item in parallel. The commands will run in the background and stream output to files. After starting the commands, you should sleep briefly and then read the output files to check results.`, }, ], }; }, - src/index.ts:163-169 (schema)The input schema for the 'create_list' tool, defining 'items' as an array of strings.
inputSchema: { items: z .array(z.string()) .describe( "Array of items to store in the list. Each item can be a file path, URL, identifier, or any string that will be substituted into commands or prompts.", ), }, - src/index.ts:148-183 (registration)The registration of the 'create_list' tool using server.registerTool, including description, input schema, and handler function.
server.registerTool( "create_list", { description: `Creates a named list of items for parallel processing. Use this tool when you need to perform the same operation across multiple files, URLs, or any collection of items. WHEN TO USE: - Before running shell commands or AI agents across multiple items - When you have a collection of file paths, URLs, identifiers, or any strings to process in parallel WORKFLOW: 1. Call create_list with your array of items 2. Use the returned list_id with run_shell_across_list or run_agent_across_list 3. The list persists for the duration of the session EXAMPLE: To process files ["src/a.ts", "src/b.ts", "src/c.ts"], first create a list, then use run_shell_across_list or run_agent_across_list with the returned id.`, inputSchema: { items: z .array(z.string()) .describe( "Array of items to store in the list. Each item can be a file path, URL, identifier, or any string that will be substituted into commands or prompts.", ), }, }, async ({ items }) => { const id = generateListId(); lists.set(id, items); return { content: [ { type: "text", text: `Successfully created a list with ${items.length} items. The list ID is "${id}". You can now use this ID with run_shell_across_list or run_agent_across_list to process each item in parallel. The commands will run in the background and stream output to files. After starting the commands, you should sleep briefly and then read the output files to check results.`, }, ], }; }, ); - src/index.ts:128-139 (helper)Helper function generateListId() that creates a unique ID for lists using diceware passphrases, ensuring no collisions with existing lists.
function generateListId(): string { const words = generatePassphrase(3); let id = words.join("-"); // Ensure uniqueness by appending more words if needed while (lists.has(id)) { const extraWord = generatePassphrase(1)[0]; id = `${id}-${extraWord}`; } return id; } - src/index.ts:125-125 (helper)Global Map 'lists' that stores all created lists by their ID, used by create_list and related tools.
const lists = new Map<string, string[]>();