omni-context-cli 0.0.33 → 0.0.35

package/dist/agents/explore.md

@@ -7,17 +7,25 @@ parameters:
     query:
       type: string
       description: What aspect of the project structure to explore
+    directory:
+      type: string
+      description: Limit the search to this directory. If not provided, searches the entire project.
   required: [query]
 ---
 
-Explore: {{query}}
+Survey the project structure and find out: {{query}}
+
+{{#if directory}}Limit the search to this directory: {{directory}}.{{/if}}
+
+Use glob to survey the file structure and identify relevant areas. Use grep to scan for where functionality lives. 
 
-Use glob to survey the file structure and identify relevant areas. Use grep to scan for where functionality lives. Focus on the big picture—what directories exist, how the project is organized, where different concerns are separated.
+Focus on the big picture: what directories exist, how the project is organized, where different concerns are separated.
 
 Return a report covering:
+- A brief overview of what you found
 - Relevant directories and their purposes
 - Key files and their roles
 - How the codebase is organized (features, layers, modules)
 - Where the queried functionality lives
 
-Keep code excerpts minimal—just enough to identify locations and responsibilities.
+Keep the report concise and to the point. Focus on what matters, skip the fluff.

package/dist/agents/glance.md

@@ -0,0 +1,58 @@
+---
+name: glance
+description: Preview multiple files at once. Reads files and directories, returns a brief summary for each file to help understand what's in them without reading the full contents.
+allowedTools: [Read, Glob, Grep]
+parameters:
+  properties:
+    paths:
+      type: array
+      items:
+        type: string
+      description: List of file or directory paths to preview.
+    recursive:
+      type: boolean
+      description: Recursively scan directories? Defaults to false.
+    maxFiles:
+      type: number
+      description: Maximum number of files to process. Defaults to 20.
+  required: [paths]
+---
+
+Preview these files and directories: {{paths}}
+
+{{#if recursive}}Recursively scan directories.{{else}}Only scan the top level of directories.{{/if}}
+
+Maximum files to process: {{#if maxFiles}}{{maxFiles}}{{else}}20 (default){{/if}}.
+
+First, expand any directories into file lists using glob. Then read each file and write a brief summary (under 100 words) describing what the file does, its main exports, or key contents.
+
+Return the summaries in this format:
+
+```
+path/to/file1.ts
+  Brief summary of what this file does, its purpose, main functions or exports.
+
+path/to/file2.tsx
+  Brief summary of this file's contents and role in the project.
+
+path/to/file3.json
+  Brief summary of the configuration or data structure.
+```
+
+If a file can't be read, note it:
+
+```
+path/to/file.bin
+  [Binary file, skipped]
+
+path/to/missing.ts
+  [File not found]
+```
+
+If the file list exceeds the limit, process only the first N files and note:
+
+```
+[Reached limit of N files, X more files not processed]
+```
+
+Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/pluck.md

@@ -1,49 +1,48 @@
 ---
 name: pluck
-description: Find and extract specific code segments. Searches project-wide or in a single file. Returns matching code with line numbers only.
-allowedTools: [Read, Grep, Glob]
+description: Find and extract specific code segments from a file. Returns matching code with line numbers only.
+allowedTools: [Read]
 parameters:
   properties:
-    filePath:
-      type: string
-      description: Path to search within. If not provided, searches across the entire project.
     query:
       type: string
-      description: What code segment to find
-  required: [query]
+      description: What code segment to find, e.g. "the registerTool function implementation", "UserService class definition", "where formatOutput is called", "error handling in the login flow"
+    filePath:
+      type: string
+      description: Exact path to the file to search within.
+  required: [query, filePath]
 ---
 
-{{#if filePath}}
-File: {{filePath}}
-{{else}}
-Search across entire project
-{{/if}}
-Query: {{query}}
+Find and extract this code segment: {{query}}
+
+Search within this file: {{filePath}}. 
 
-{{#if filePath}}
-Read the specified file and locate the code segment that matches the query.
-{{else}}
-First use glob and grep to search across the project and identify which file contains the code segment that matches the query. Then read that file to extract the exact code.
-{{/if}}
+Read the file and locate the code segment that matches the query.
 
-Return ONLY the matching code segments with their file paths and line numbers in this exact format. If multiple matches are found, list all of them separated by "---":
+Return what you find in this format:
 
 ```
 File: path/to/file.ts
 Lines X-Y:
-<code>
+<the matching code>
 ```
 
-If there are multiple matches:
+If there are multiple matches, separate them like this:
 
 ```
 File: path/to/file1.ts
 Lines X-Y:
-<code>
+<the matching code>
 ---
 File: path/to/file2.ts
 Lines A-B:
-<code>
+<the matching code>
+```
+
+If you can't find what was asked for:
+
+```
+Couldn't find it: [brief explanation of what you searched and why nothing matched]
 ```
 
 Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/quest.md

@@ -9,29 +9,38 @@ parameters:
       description: What to research.
     expectedResult:
       type: string
-      description: What result you expect—like "latest version number", "list of best practices", "comparison of approaches", or "code examples".
+      description: What result you expect, like "latest version number", "list of best practices", "comparison of approaches", or "code examples".
   required: [query, expectedResult]
 ---
 
-Query: {{query}}
-Expected result: {{expectedResult}}
+Research this topic: {{query}}
 
-Use available web search tools and external knowledge bases to research the query. Gather information from multiple sources if needed for a comprehensive answer.
+Expected result: {{expectedResult}}.
+
+Use available web search tools and external knowledge bases to find the answer.
+
+Gather information from multiple sources if needed for a comprehensive result.
+
+Return what you find in this format:
 
-Extract and return the result according to the expected result description in this exact format:
 ```
-Result: [extracted result matching the expected result description]
+Here's what I found: [the result matching what was expected]
 ```
 
-If sources are relevant, you may include them in a brief format:
+If sources are worth mentioning:
+
 ```
-Result: [extracted result matching the expected result description]
-Sources: [brief list of sources if relevant]
+Here's what I found: [the result matching what was expected]
+
+Sources:
+- [source 1]
+- [source 2]
 ```
 
-If the research cannot find relevant information, return:
+If you couldn't find relevant information:
+
 ```
-Not found: [brief explanation of what was searched]
+Couldn't find this: [brief explanation of what you searched and why nothing turned up]
 ```
 
 Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/ripple.md

@@ -12,36 +12,46 @@ parameters:
       description: Name of the symbol to find references for
     symbolType:
       type: string
-      description: Type of symbol—function, class, interface, variable, etc. Helps narrow the search.
-    contextLines:
-      type: number
-      description: Lines to include before and after each reference. Defaults to 5.
+      description: Type of symbol (function, class, interface, variable, etc.). Helps narrow the search.
   required: [filePath, symbolName]
 ---
 
-File: {{filePath}}
-Symbol: {{symbolName}}{{#if symbolType}} ({{symbolType}}){{/if}}
+Find all references to a symbol in the codebase.
 
-Use grep and glob to search for all places where the symbol is referenced. For each reference found, read the file and extract the code snippet with {{#if contextLines}}{{contextLines}}{{else}}5{{/if}} lines of context before and after.
+Symbol name: {{symbolName}}.
 
-Return the reference sites in this exact format. For each location found, include:
+{{#if symbolType}}Symbol type: {{symbolType}}.{{/if}}
+
+Defined in: {{filePath}}.
+
+Use grep and glob to search for all places where this symbol is referenced.
+
+For each reference found, read the file and extract the code snippet with 5 lines of context before and after.
+
+Return the references in this format:
 
 ```
 File: path/to/file.ts
 Lines X-Y:
-<code>
+<the code with context>
 ```
 
-If multiple reference sites are found, separate each with "---":
+If there are multiple references, separate them like this:
 
 ```
 File: path/to/file1.ts
 Lines X-Y:
-<code>
+<the code with context>
 ---
 File: path/to/file2.ts
 Lines A-B:
-<code>
+<the code with context>
+```
+
+If you can't find any references:
+
+```
+No references found: [brief explanation of what you searched]
 ```
 
 Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/sculpt.md

@@ -6,7 +6,7 @@ parameters:
   properties:
     filePath:
       type: string
-      description: File to edit—relative or absolute path.
+      description: File to edit, relative or absolute path.
     oldString:
       type: string
       description: Exact text to replace. Must match perfectly, including whitespace and indentation.
@@ -19,44 +19,44 @@ parameters:
   required: [filePath, oldString, newString]
 ---
 
-Target file: {{filePath}}
-{{#if replaceAll}}
-Replace all occurrences.
-{{else}}
-Replace single occurrence only.
-{{/if}}
+Edit this file by replacing text: {{filePath}}
 
-Old text to replace:
-<oldString>
+{{#if replaceAll}}Replace all occurrences of the old text.{{else}}Replace only the first occurrence.{{/if}}
+
+Old text to find and replace:
+
+<old_text>
 {{oldString}}
-</oldString>
+</old_text>
+
+New text to insert:
 
-New text:
-<newString>
+<new_text>
 {{newString}}
-</newString>
+</new_text>
 
-First, attempt to edit the file using the edit tool.
+Try to make the edit using the edit tool.
+
+If it works, return:
 
-If the edit succeeds, return the result immediately in this exact format:
 ```
-Success: Edited /path/to/file
+Done: Edited {{filePath}}
 ```
 
-If the edit fails, analyze the error and attempt to fix it.
+If it fails, figure out why. Maybe the text doesn't match exactly, or there's a whitespace issue. Fix it and try again.
 
-After fixing, retry the edit operation.
+If the fix worked:
 
-If it succeeds, return:
 ```
-Success after fix: Edited /path/to/file
-Fixed issue: [brief description of what was fixed]
+Done: Edited {{filePath}}
+What I fixed: [quick note on what was off and how you corrected it]
 ```
 
-If all attempts fail, return:
+If nothing worked after a few tries:
+
 ```
-Failed: [error description]
-Attempted fixes: [what was tried]
+Couldn't complete this: [what went wrong]
+What I tried: [the fixes you attempted]
 ```
 
 Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/slice.md

@@ -0,0 +1,41 @@
+---
+name: slice
+description: Extract code snippets relevant to answering a specific question. Returns targeted code segments from across the codebase that address the query.
+allowedTools: [Read, Grep, Glob, Bash, BashOutput]
+parameters:
+  properties:
+    question:
+      type: string
+      description: What you want to understand. Be specific, like "How does session persistence work?" or "Where are tool calls dispatched?"
+    directory:
+      type: string
+      description: Limit the search to this directory. If not provided, searches the entire project.
+  required: [question]
+---
+
+Find and extract code that answers this question: {{question}}
+
+{{#if directory}}Limit the search to this directory: {{directory}}.{{/if}}
+
+Use grep to search for keywords related to the question. Trace function calls, imports, and references.
+
+Use glob to identify relevant files based on your grep findings.
+
+Read the files that contain the answer to the question. Focus on the specific code sections that address what's being asked.
+
+For complex flows, read multiple files to understand the complete picture.
+
+Return the code in this format. Use line ranges when only a section is relevant, complete contents for small files:
+
+```
+File: path/to/file.ts
+Lines X-Y:
+<relevant code segment>
+---
+File: path/to/another.ts
+<complete file contents>
+```
+
+If the code references other parts that explain the answer, include those too.
+
+Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/spark.md

@@ -1,31 +1,52 @@
 ---
 name: spark
-description: Handle ultra-specific, step-by-step tasks that require zero judgment or analysis. Only use for foolproof mechanical operations with exact instructions.
-allowedTools: [Read, Write, Edit, Glob, Grep, Bash, BashOutput]
+description: Execute bash commands when no suitable specialized tool exists. Automatically fixes errors and retries if the command fails.
+allowedTools: [Bash, BashOutput, Read, Write]
 parameters:
   properties:
-    task:
+    command:
       type: string
-      description: The specific task to complete. Be concrete and unambiguous—state exactly what to do and what the end result should look like.
-  required: [task]
+      description: Bash command to run. Pipes, redirects, and chains all work.
+    expectedResult:
+      type: string
+      description: What result you expect from this command, like "list of JavaScript files", "successful installation message", or "version number".
+    timeout:
+      type: number
+      description: Max runtime in milliseconds. Defaults to 120000 (2 minutes).
+    workdir:
+      type: string
+      description: Where to run the command, relative or absolute path. Defaults to current directory.
+  required: [command, expectedResult]
 ---
 
-Task: {{task}}
+Use the bash tool to run this command: {{command}}
+
+Working directory: {{#if workdir}}{{workdir}}{{else}}current directory{{/if}}.
 
-Execute this task directly. Don't ask questions or propose alternatives—just do it.
+Timeout: {{#if timeout}}{{timeout}}ms{{else}}120000ms (2 minutes){{/if}}.
 
-Follow these rules:
-1. Take the most straightforward path to complete the task
-2. If something is unclear, make a reasonable assumption and proceed
-3. Don't add anything beyond what was asked
-4. Don't refactor or improve unrelated code
+Expected result: {{expectedResult}}.
+
+If it works, extract what was asked for and return:
 
-When done, return the result in this format:
 ```
-Done: [brief summary of what was completed]
+Done: [the result matching what was expected]
 ```
 
-If the task cannot be completed, return:
+If something goes wrong, figure out why and fix it. Then try again.
+
+If the fix worked, return:
+
 ```
-Blocked: [what's preventing completion]
+Done: [the result matching what was expected]
+What I fixed: [quick note on what went wrong and how you fixed it]
 ```
+
+If nothing worked after a few tries, return:
+
+```
+Couldn't complete this: [what went wrong]
+What I tried: [the fixes you attempted]
+```
+
+Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/sweep.md

@@ -6,19 +6,25 @@ parameters:
   properties:
     query:
       type: string
-      description: What files to find—like "configuration files", "React components", or "test files for user authentication".
+      description: What files to find, like "configuration files", "React components", or "test files for user authentication".
+    directory:
+      type: string
+      description: Limit the search to this directory. If not provided, searches the entire project.
     maxFiles:
       type: number
       description: Maximum number of files to return. Defaults to 50.
   required: [query]
 ---
 
-Query: {{query}}
-Max files to return: {{#if maxFiles}}{{maxFiles}}{{else}}50{{/if}}
+Find files in the project that match this criteria: {{query}}
+
+{{#if directory}}Limit the search to this directory: {{directory}}.{{/if}}
 
-Use glob and grep to search across the project for files matching the criteria.
+Maximum files to return: {{#if maxFiles}}{{maxFiles}}{{else}}50 (default){{/if}}.
 
-Return ONLY the list of matching file paths in this exact format:
+Use glob and grep to search for matching files. Only return file paths, don't read the contents.
+
+Return just the list of matching file paths:
 
 ```
 path/to/file1.ts
@@ -26,6 +32,12 @@ path/to/file2.tsx
 path/to/file3.json
 ```
 
-If more files match than the maximum limit, return the most relevant ones.
+If more files match than the limit allows, return the most relevant ones.
+
+If you can't find any matching files:
+
+```
+Couldn't find any matches: [brief explanation of what you searched]
+```
 
 Do not include explanations beyond the result format. Keep responses concise and structured.

package/dist/agents/weave.md

@@ -6,7 +6,7 @@ parameters:
   properties:
     filePath:
       type: string
-      description: Destination path—relative or absolute. Parent directories created automatically.
+      description: Destination path, relative or absolute. Parent directories created automatically.
     content:
       type: string
       description: Complete file content. Replaces everything in the file.
@@ -16,39 +16,38 @@ parameters:
   required: [filePath, content]
 ---
 
-Target file: {{filePath}}
-{{#if createOnly}}
-Only create new file, do not overwrite if exists.
-{{else}}
-Overwrite file if it exists.
-{{/if}}
+Write content to this file: {{filePath}}
+
+{{#if createOnly}}Only create the file if it doesn't exist. Do not overwrite existing files.{{else}}Overwrite the file if it already exists.{{/if}}
 
 Content to write:
-<content>
+
+<file_content>
 {{content}}
-</content>
+</file_content>
 
-First, attempt to write the content using the write tool.
+Try to write the content using the write tool.
+
+If it works, return:
 
-If the write succeeds, return the result immediately in this exact format:
 ```
-Success: Wrote N lines to /path/to/file
+Done: Wrote N lines to {{filePath}}
 ```
 
-If the write fails, analyze the error and attempt to fix it.
+If it fails, figure out why and fix it. Then try again.
 
-After fixing, retry the write operation.
+If the fix worked:
 
-If it succeeds, return:
 ```
-Success after fix: Wrote N lines to /path/to/file
-Fixed issue: [brief description of what was fixed]
+Done: Wrote N lines to {{filePath}}
+What I fixed: [quick note on what went wrong and how you fixed it]
 ```
 
-If all attempts fail, return:
+If nothing worked after a few tries:
+
 ```
-Failed: [error description]
-Attempted fixes: [what was tried]
+Couldn't complete this: [what went wrong]
+What I tried: [the fixes you attempted]
 ```
 
 Do not include explanations beyond the result format. Keep responses concise and structured.