@saifymatteo/pi-agent-ask

Let your Pi agent ask instead of guessing, and keep working while you answer

Packages

Package details

extension

Install @saifymatteo/pi-agent-ask from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@saifymatteo/pi-agent-ask

Package: @saifymatteo/pi-agent-ask
Version: 1.2.0
Published: Nov 7, 2026
Downloads: 1,106/mo · 270/wk
Author: saifymatteo
License: MIT
Types: extension
Size: 371.3 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "image": "https://raw.githubusercontent.com/saifymatteo/pi-agent-ask/main/assets/ask-gallery.webp",
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-agent-ask

A trimmed fork of the Pi ask extension, published as @saifymatteo/pi-agent-ask. An agent asks you a structured question and keeps working while you answer; wait_for_answers is the explicit blocking gate.

Upstream

The original features and their full documentation live upstream:

alexshpunt/pi-agent-ask — the direct upstream this repo forks (original README)
eko24ive/pi-ask — the original project that upstream builds on (original README)
maudelv/pi-ask, branch feat/herdr-blocked-state — source of the Herdr blocked-state support

Install

pi install npm:@saifymatteo/pi-agent-ask

Remove any other pi-ask installation so only one extension provides ask_user, then reload Pi.

Our changes

Differences from upstream:

trimmed the agent-facing surface to two tools, ask_user and wait_for_answers, with compact descriptions to cut agent context
removed the agent-facing history tools, the bundled skill, the config system-prompt line, and external UI negotiation
kept the interactive form UI, background question queue, journal-based form recovery, and Herdr blocked state
integrated clipboard providers: compatible clipboard extensions can serve image pastes in answers and notes, with built-in clipboard reading as fallback
guided agents to use previewFile for long previews already on disk instead of copying the text into tool calls

Fork-specific docs: configuration, tool contract, integration events.

Long previews

Long file proposals stay inside Ask's styled preview pane. Use PageUp/PageDown to page through the text or Home/End to jump to its beginning/end; an overflowing pane shows the visible row range. Options and footer controls stay outside the paged content. These keys continue to control text editing while an answer or note editor is open.

In fullscreen mode, hover over the preview and use the mouse wheel to scroll its text. Hover over the transcript to scroll that instead. Scrolling stops at the preview's ends without spilling into the transcript or changing keyboard focus. In regular mode, the terminal owns mouse scrolling; use the keyboard to page the preview.

License

MIT