@piotr-oles/pi-bash-timeout

Pi Agent extension that gives the bash tool a sane default timeout and tells the model about the timeout policy.

It intercepts the host bash tool via the tool_call event and injects a default timeout (in seconds) when the model omits it or passes a non-positive value. It also appends a "Bash Tool Timeout Policy" section to the system prompt via before_agent_start so the model sets explicit timeouts for long-running commands.

Behavior

| Case | Result | |------|--------| | timeout omitted | inject default | | timeout <= 0 | treated as missing, inject default | | timeout in range | preserved | | timeout above max | capped to max |

Non-bash tool calls are never touched.

Configuration

Both pi flags and env vars are supported. Precedence: flag > env var > built-in default. Invalid or non-positive values are ignored and fall through to the next source.

| Setting | Flag | Env var | Default | |---------|------|---------|---------| | Default timeout (s) | pi-bash-timeout-default | PI_BASH_DEFAULT_TIMEOUT_SECONDS | 120 | | Maximum timeout (s) | pi-bash-timeout-max | PI_BASH_MAX_TIMEOUT_SECONDS | 600 |

Explicit timeout values above max are capped. If max resolves lower than default, it is raised to default.

Thanks

Ported from code-yeongyu/pi-bash-timeout and adapted to this repo (pi flags, upstream isToolCallEventType guard, in-place input mutation, colocated tests).

Development

pnpm install
pnpm test
pnpm typecheck
pnpm check

To test changes manually, pass the source entry point directly to pi:

pi -e packages/pi-bash-timeout/src/index.ts