@wierdbytes/pi-ask0.1.0
Interactive ask_user clarification tool for the pi coding agent that reports pi as blocked (OSC 7501) while a question waits — fork of @eko24ive/pi-ask
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
@wierdbytes/pi-ask
Interactive ask_user clarification tool for the
pi coding agent: the agent pauses,
asks structured questions in a terminal UI, and continues with normalized
answers instead of guessing.
Fork of @eko24ive/pi-ask 1.2.0 by
eko24ive (MIT). Same tool, commands and UI, plus:
- Blocked status for agent dashboards. While a form is open, pi reports
itself as
blockedon aquestionvia program status (OSC 7501), so herdr, Rex and other OSC 7501 terminals play their "needs you" alert instead of showing the agent asworking. Needs pi >= 1.5.0; older pi just ignores it.
Install
pi remove npm:@eko24ive/pi-ask # both register ask_user — keep only one
pi install npm:@wierdbytes/pi-ask
What you get
ask_usertool — tabbed single / multi / preview questions,(recommended)markers, inline "Type your own" answers,@file references, option and question notes, a review tab with Submit / Elaborate / Cancel./ask-settings— toggle behaviour and notifications, show the config path, reset to defaults (also?inside a form)./answer— extract questions the agent asked in plain text from its last message into a form;/answer:againreopens the latest one./ask:replay— reopen the latestask_userform on the current branch.- Recovery of an unanswered
ask_userform after startup, resume or fork. - Bundled
ask-userskill that tells the agent when to ask (disable viapi config).
Config
~/.pi/agent/@wierdbytes/pi-ask/settings.json — keymaps, behaviour,
notifications (bell, osc9, osc777) and /answer extraction models.
Created with defaults on first use.
Full reference: docs/configuration.md. The agent
reads it when you ask it to tweak pi-ask settings.
Remote events
Trusted in-process extensions can watch and answer forms over pi.events:
@wierdbytes/pi-ask:started, :completed, :submit, :submit-result.
Upstream bridges listening on @eko24ive/pi-ask:* need the new prefix. See
docs/remote-events.md.
Docs
docs/contract.md— tool input/output and UX guaranteesdocs/configuration.md— config file referencedocs/remote-events.md—pi.eventsbridge contract
Development
bun run test
pi -e ./index.ts
License
MIT — © eko24ive (original @eko24ive/pi-ask), © wierdbytes (fork changes).