pi-zed-plugin

Zed terminal tab spinner, completion bell, and AI-generated session titles for the Pi coding agent

Packages

Package details

extension

Install pi-zed-plugin from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-zed-plugin
Package
pi-zed-plugin
Version
0.1.0
Published
Aug 3, 2026
Downloads
192/mo · 13/wk
Author
yukikisaku
License
MIT
Types
extension
Size
40.8 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-zed-plugin

Zed terminal status for the Pi coding agent.

  • Spinner on the terminal tab title while the agent is working.
  • Completion bell when the agent finishes, which makes Zed raise its own notification if that terminal is not focused.
  • AI-generated title as the tab title, so bash becomes Fix OAuth callback.

Install

pi install npm:pi-zed-plugin

It activates only inside Zed's terminal, which Zed marks with TERM_PROGRAM=zed and ZED_TERM=true, and stays completely inactive anywhere else.

Inside tmux it stands down entirely and leaves the title to a tmux-aware extension such as pi-tmux. tmux rewrites TERM_PROGRAM to tmux and can hand down a stale ZED_TERM from whichever client started the server, so $TMUX always wins.

Commands

/rename                     regenerate the tab title from the whole conversation
/rename Fix OAuth callback  set the tab title explicitly

/pi-zed-plugin              show current settings
/pi-zed-plugin spinner off  turn the spinner off
/pi-zed-plugin style braille
/pi-zed-plugin speed slow
/pi-zed-plugin bell off     turn the completion bell off
/pi-zed-plugin naming off   turn AI titles off
/pi-zed-plugin naming-model openai/gpt-5-mini

Settings live in ~/.pi/agent/pi-zed-plugin.json.

Title generation

Titles are generated by the model the session is already running on, at low thinking effort, in the language you wrote in. Set naming-model to use a cheaper model instead, or - to go back to the session model.

License

MIT