@mrclrchtr/supi-bash-timeout

Adds one small safety feature to the pi coding agent: if the model calls bash without a timeout, this package fills one in.

Install

pi install npm:@mrclrchtr/supi-bash-timeout

For local development:

pi install ./packages/supi-bash-timeout

What you get

After install, every bash tool call is checked before execution:

• if the model already set timeout, that value is kept
• if timeout is missing, this package injects a default value
• other tools are untouched

Default timeout: 120 seconds

This is useful when you want a guardrail against hung commands in long or unattended sessions.

Settings

This package registers a Bash Timeout section in /supi-settings.

Available setting:

• defaultTimeout — default timeout for bash tool calls, in seconds

Config is stored in the standard SuPi config files:

• global: ~/.pi/agent/supi/config.json
• project: .pi/supi/config.json

Example:

{
  "bash-timeout": {
    "defaultTimeout": 300
  }
}

Invalid values are ignored and fall back to the built-in default of 120.

Source

• src/bash-timeout.ts — intercepts bash tool calls and injects missing timeouts
• src/config.ts — config loading and default values
• src/settings-registration.ts — /supi-settings registration