@arvoretech/pi-warp-tab-title

PI extension that lets the LLM rename the Warp terminal tab to reflect the current task focus

Packages

Package details

extension

Install @arvoretech/pi-warp-tab-title from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@arvoretech/pi-warp-tab-title
Package
@arvoretech/pi-warp-tab-title
Version
1.0.1
Published
Jun 23, 2026
Downloads
202/mo · 23/wk
Author
joao.barros.arvore
License
MIT
Types
extension
Size
15 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

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

README

@arvoretech/pi-warp-tab-title

PI extension that lets the LLM rename the Warp terminal tab to reflect the current task focus.

What it does

Registers a set_tab_title({ emoji, summary }) tool that the LLM can call when the focus of the conversation changes (new task, different repo, different phase). The tool emits an OSC 0 escape sequence via ctx.ui.setTitle(), which Warp picks up to rename the active tab.

The last title is persisted in the session via appendEntry, so it is restored on --resume and on tree navigation.

Behavior

  • Initial title on session_start: 🤖 {sessionName} · {cwd} (or just 🤖 {cwd}).
  • Tool call: LLM sets { emoji, summary } → tab becomes <emoji> <summary>.
  • Resume / tree navigation: restores the most recent title from session entries.
  • Shutdown: restores 🤖 {cwd}.

Examples

  • 📝 Refinement EXP-231
  • 🐛 Debug pi-tui crash
  • 🚀 Deploy api-arvore staging
  • 🔍 Investigar fraude La Salle

Notes

  • Works in Warp (via OSC 0). Other terminals that honor OSC 0/2 should also work.
  • In RPC / print modes, setTitle is a no-op — safe.