@yukikisaku/pi-orca-status
v0.2.0
Published
Orca completion marks and AI-generated tab titles for the Pi coding agent
Maintainers
Readme
@yukikisaku/pi-orca-status
Completion marks and AI-generated Orca tab titles for the Pi coding agent.
Orca already shows its own spinner and plays its own completion sound, but every Pi tab is still
labelled Pi. This extension names each tab after what the session is actually doing, so Pi
becomes Fix OAuth callback, and prefixes it with 🔔 when the agent finishes.
The mark clears automatically after you select the tab, or when the agent starts working again. No extra completion sound is played.
Install
pi install npm:@yukikisaku/pi-orca-statusIt activates only inside Orca (ORCA_PANE_KEY) and stays completely inactive anywhere else.
Orca normalises Pi's terminal title to Pi for its own status display, so the tab label is set
through the Orca CLI. When the CLI is unavailable the extension falls back to the terminal title.
Commands
/rename regenerate the tab title from the whole conversation
/rename Fix OAuth callback set the tab title explicitly
/pi-orca open the settings menuUse the arrow keys to move, Enter or Space to change a value, and Escape to close the menu. String
and number settings open an input screen. Changes are applied and saved immediately. Any arguments
to /pi-orca are ignored, so it always opens the same menu.
Settings live in ~/.pi/agent/pi-orca.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 in the settings menu to use a cheaper model instead, or
clear the field to go back to the session model.
Following renames from the host
The tab title always follows the session's own title. Renames that happen outside this extension
— plain Pi's /name, Oh My Pi's builtin /rename, a rename from another extension — are mirrored
through the Orca CLI without rewriting the session. Oh My Pi announces no rename event, so its
renames are picked up by a lightweight watcher that re-reads the session name once per second and
only calls Orca when it actually changed. An explicitly set title also stops any AI-generated
rename that is still in flight, so it is never overwritten afterwards.
License
MIT
Pull requests
Pull requests are handled in the pi-agent-status repository, which defines the AI review and automatic merge policy and activation conditions.
