# pi-orca

Completion marks and AI-generated Orca tab titles for the [Pi coding agent](https://pi.dev).

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

```bash
pi install npm:pi-orca
```

It 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 menu
```

Use 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.

## License

MIT