pi-warp

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# pi-warp

Real-time [pi](https://github.com/earendil-works/pi-coding-agent) notifications in the [Warp](https://www.warp.dev/) terminal.

pi-warp surfaces pi agent activity inline in Warp — so you always know what the agent is doing without switching context.

![](https://github.com/TeahouseHQ/pi-warp/raw/HEAD/static/demo.gif)

## Features

- **Session tracking** — Warp knows when pi starts and stops a session.
- **Prompt notifications** — see when your prompt has been submitted and the agent begins working.
- **Completion signal** — Warp tells you when the agent has finished its work.
- **Animated terminal title** — an optional braille spinner in your terminal title while the agent is busy.

## Requirements

- **[Warp](https://www.warp.dev/)** — build newer than `v0.2026.03.25.08.24.stable_05` (stable) or `v0.2026.03.25.08.24.preview_05` (preview). Dev channel builds are always supported.
- **[pi](https://github.com/earendil-works/pi-coding-agent)** coding agent.

> pi-warp detects Warp automatically. If you're running an incompatible build or not inside Warp, the extension silently disables itself — nothing breaks.

## Installation

```bash
pi install npm:pi-warp
```

Or manually: clone this repository into your pi extensions directory (`~/.pi/agent/extensions/`).

## Usage

No configuration needed — notifications start automatically when you launch pi inside Warp.

You'll see inline Warp notifications as the agent:

1. **Starts a session** — confirms the extension is active.
2. **Receives your prompt** — shows the agent is working.
3. **Finishes its work** — lets you know the agent is done.

### Settings

Run the following command inside pi to open the settings panel:

```
/pi-warp-settings
```

| Setting | Default | Description |
|---|---|---|
| **Dynamic Terminal Titles** | on | Animate the terminal title with a braille spinner while the agent is working |

<details>
<summary>Editing settings directly</summary>

Settings are stored in pi's global config at `~/.pi/agent/settings.json` under the `piWarp` key:

```json
{
  "piWarp": {
    "dynamicTitles": false
  }
}
```

</details>

## Troubleshooting

**I don't see any notifications**

- Make sure you're running pi **inside Warp** (not another terminal emulator).
- Check your Warp version meets the minimum listed in [Requirements](#requirements).
- pi-warp prints a message on session start if Warp was not detected — look for it in your pi log.

**Notifications stopped after a Warp update**

- Warp may have changed its environment variables. Open a new terminal window and try again.
- If the issue persists, [file an issue](https://github.com/TeahouseHQ/pi-warp/tree/HEAD/../../issues).

**The spinner in the terminal title is distracting**

- Run `/pi-warp-settings` in pi and set **Dynamic Terminal Titles** to `off`.

## License

MIT

pi-warp

Real-time pi notifications in the Warp terminal.

pi-warp surfaces pi agent activity inline in Warp — so you always know what the agent is doing without switching context.

Features

Session tracking — Warp knows when pi starts and stops a session.
Prompt notifications — see when your prompt has been submitted and the agent begins working.
Completion signal — Warp tells you when the agent has finished its work.
Animated terminal title — an optional braille spinner in your terminal title while the agent is busy.

Requirements

Warp — build newer than v0.2026.03.25.08.24.stable_05 (stable) or v0.2026.03.25.08.24.preview_05 (preview). Dev channel builds are always supported.
pi coding agent.

pi-warp detects Warp automatically. If you're running an incompatible build or not inside Warp, the extension silently disables itself — nothing breaks.

Installation

pi install npm:pi-warp

Or manually: clone this repository into your pi extensions directory (~/.pi/agent/extensions/).

Usage

No configuration needed — notifications start automatically when you launch pi inside Warp.

You'll see inline Warp notifications as the agent:

Starts a session — confirms the extension is active.
Receives your prompt — shows the agent is working.
Finishes its work — lets you know the agent is done.

Settings

Run the following command inside pi to open the settings panel:

/pi-warp-settings

Setting	Default	Description
Dynamic Terminal Titles	on	Animate the terminal title with a braille spinner while the agent is working

Editing settings directly

Settings are stored in pi's global config at ~/.pi/agent/settings.json under the piWarp key:

{
  "piWarp": {
    "dynamicTitles": false
  }
}

Troubleshooting

I don't see any notifications

Make sure you're running pi inside Warp (not another terminal emulator).
Check your Warp version meets the minimum listed in Requirements.
pi-warp prints a message on session start if Warp was not detected — look for it in your pi log.

Notifications stopped after a Warp update

Warp may have changed its environment variables. Open a new terminal window and try again.
If the issue persists, file an issue.

The spinner in the terminal title is distracting

Run /pi-warp-settings in pi and set Dynamic Terminal Titles to off.

License

MIT