Advanced Tool Usage

Core Principles

• Context Economy: Never bring raw, voluminous data into the conversation if you only need a refined subset.
• Pipeline Thinking: View tools as modular blocks that can pass data through files.
• Offloading: Use redirect_tool_call to "capture" output into external storage.

Patterns

1. The Pipelining Pattern

When a tool's output is the input for another tool:

1. Redirect: Call the first tool using redirect_tool_call.
2. Process: Call the second tool (e.g., python_execute or shell_execute) and pass the file path created in step 1 as an argument.
3. Refine: Read only the final processed result into the conversation.

2. The Context Buffer Pattern

When working with large files or long logs:

• Redirect the reading tool (e.g., cat, mcp_call) to a temporary file.
• Use rg or grep to extract only the relevant lines from that file.