pi-rust

Terminal

Themes

To select a harness theme, open /settings and select Theme. The themes are system, dark, and light, plus these added dark palettes:

Theme Based on
ghostty The Ghostty default colors
darcula-islands JetBrains Darcula and Islands
nord Nord
catppuccin Catppuccin Mocha

Notifications

In interactive mode, when a run takes 10 seconds or more, pi sends a terminal notification at the end. Its title is “pi”. The text is “Done” or the error.

Terminal Sequence
Ghostty, WezTerm, foot, and rxvt OSC 777
kitty OSC 99
iTerm2 and Windows Terminal OSC 9
Other terminals, for example tmux and screen BEL

In fullscreen mode, pi does not send the notification while the terminal reports focus.

Settings:

  • terminal.notifyOnFinish: "auto" (the default), "osc", "bell", or "off".
  • terminal.notifyMinSeconds: the minimum run time for a notification, in seconds. The default is 10.

iTerm2 integration

The iTerm2 integration is the marketplace:iterm2 extension. Earlier pi-rust versions had it built in. The extension does these things:

  • It sets the tab color from the agent state.
  • It shows a badge with the session name.
  • It sets user variables.
  • It requests attention when a run finishes.
  • It adds /terminal-setup.

To install it:

pi install marketplace:iterm2

The extension reads terminal.iterm2 in ~/.pi/agent/settings.json, so an existing setting continues to work. See the extension’s documentation in yannelli/pi-rust-extensions.

When terminal.iterm2 is on and the extension is not installed, interactive mode asks one time at startup to install it, with the choices Install, Not now, and Do not ask again. Without the extension, /terminal-setup shows the install command. iTerm2 inline images (terminal.images) are part of pi and need no extension.

Try