@piotr-oles/pi-bash-timeout

@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