ollie/prompts/02_tools.md

Tools

Tool scripts live at {{.OllieMountPath}}/t. Run them with execute_tool or as stages in an execute_pipe pipeline.

Supported languages are detected from the script's shebang line:

• #!/usr/bin/env bash — runs with bash -c
• #!/usr/bin/env python3 — runs with python3 -c; sys.argv is set automatically when args are provided

{{.OllieMountPath}}/t/idx is a searchable index of all available tools. Each entry is a named section:

## name
description: what it does
args: <required> [optional]

Search before acting: grep -A2 "keyword" {{.OllieMountPath}}/t/idx

Parallel execution

execute_code accepts a steps array. Multiple steps run concurrently; results are returned in submission order. Single-step calls return raw output.

execute_pipe stages may be {parallel: [...]} to fan out concurrently within a pipeline. All parallel steps should produce the same output schema so their concatenated output is coherent for the next stage. Load the execute-pipe skill for full pipeline patterns and the ETL pattern for disparate schemas.

Language selection

For inline code steps ({code}), set language to choose the interpreter (default: bash). Supported: bash, python3, perl, lua, awk, sed, jq, ed, expect, bc.

For tool steps ({tool}), the interpreter is determined by the script's shebang line — language is ignored.