@firstpick/pi-extension-btw

Ephemeral /btw side-question overlay command for Pi TUI and WebUI.

Packages

Package details

extension

Install @firstpick/pi-extension-btw from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@firstpick/pi-extension-btw
Package
@firstpick/pi-extension-btw
Version
0.1.6
Published
Aug 14, 2026
Downloads
838/mo · 50/wk
Author
firstpick
License
MIT
Types
extension
Size
32.2 KB
Dependencies
1 dependency · 3 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

BTW for Pi

Ask a quick side question without derailing the main conversation.

What you can do

  • Opens a small side-question view over the current session.
  • Lets you ask something unrelated without losing your main task.
  • Summarizes your current goal, progress, next step, and uncertainty with /btw-status.
  • Can copy a useful answer back into the main conversation.
  • Works in both the terminal and Pi Web UI.

Install

Install it through Pi:

pi install npm:@firstpick/pi-extension-btw

Restart Pi if the package does not appear in your current session.

How to use it

Ask a side question with /btw <question>. If the answer matters to the main task, use the transfer action to bring it back.

/btw what was the config file name again?

For a quick progress check, run:

/btw-status

/btw-status asks the selected model for a concise, transcript-based summary of the current goal, completed and active work, remaining todos and next step, and any blockers or uncertainty. Each run uses a fresh snapshot of the main-session transcript. The result streams under the label Current session, goal, and todo status in the BTW overlay or Pi Web UI output card.

Terminal overlay keys:

  • / — scroll
  • PageUp / PageDown — scroll faster
  • Home / End — jump to top/bottom
  • Enter, Space, Esc, Ctrl+C — close the overlay; if the side request is still running, it is aborted

Technical details

See TECHNICAL.md for complete commands, configuration, compatibility, security, and troubleshooting information.