@carlosgtrz/pi-terminal-bell

Pi extension that rings the terminal bell when an agent run finishes after a configurable timeout.

Package details

extension

Install @carlosgtrz/pi-terminal-bell from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@carlosgtrz/pi-terminal-bell

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

Pi extension that rings the terminal bell when an agent run finishes after a configurable timeout.

By default, it rings only when the agent ran for at least 5 seconds. Use -1 to disable it.

pi install npm:@carlosgtrz/pi-terminal-bell

Try without installing permanently:

pi -e npm:@carlosgtrz/pi-terminal-bell

For one-off testing from this repo:

pi -e ./packages/terminal-bell

Default behavior: ring after runs that take 5 seconds or longer.

pi

Change the timeout:

pi --terminal-bell-timeout 10

Ring for every completed agent run:

pi --terminal-bell-timeout 0

Disable the bell:

pi --terminal-bell-timeout -1

The extension writes the ASCII BEL character to stderr, so it does not interfere with normal stdout output.

MIT