pi-questions

Structured inline questions for Pi. Multi-tab categories, built-in free-text fallback answers, and bridge-driven replies.

Highlights

• question tool for multiple-choice question tabs with a bottom Something else free-text fallback row by default.
• Editor-area UI by default; optional floating overlay.
• OpenCode-style question UI: tab hints and highlighted active rows.
• Compact answered tool output lists every category answer and expands inline to show each question with the selected choice marked.
• Wrapped option labels stay readable in narrow panes.
• pi-session-bridge integration lets external clients list, answer, and reject pending questions.
• When the bridge is loaded, question opened/answered/rejected lifecycle points publish structured question.* activity broker events without adding chat messages.
• pi-qol notification hook fires before prompts open.

Install

Via npm:

pi install npm:@vanillagreen/pi-questions

Via vstack:

cargo install --git https://github.com/vanillagreencom/vstack.git vstack
vstack add vanillagreencom/vstack --pi-extension pi-questions --harness pi -y

Restart Pi after installation.

Payload

{
  "id": "que_example",
  "header": "Choose next action",
  "questions": [
    {
      "header": "Issue Missing",
      "question": "How should I proceed?",
      "options": [
        { "label": "Use current branch", "description": "Continue without a tracker issue." },
        { "label": "Stop here", "description": "Wait for operator guidance." }
      ],
      "multiple": false,
      "customLabel": "Something else"
    }
  ]
}

Result:

{ "requestId": "que_example", "answers": [["Stop here"]] }

Cancelled:

{ "requestId": "que_example", "cancelled": true }

Every tab includes a bottom free-text fallback row by default, labelled Something else unless customLabel overrides it. Agents no longer need to set allowCustom for a basic escape hatch; the legacy flag is still accepted for compatibility, and allowCustom: false does not disable the fallback. customPlaceholder customizes the input hint.

When the user types fallback text, the result uses the same answer shape as fixed options:

{ "requestId": "que_example", "answers": [["Use issue ABC-123 instead"]] }

Do not include a final Confirm, Submit, Review, or Done question tab in the payload; the UI adds its own submit tab when needed.

Settings

Open /extensions:settings; settings appear under the Questions tab.

Project settings in .pi/settings.json apply only after Pi marks the workspace trusted; before trust, vstack Pi extensions read user/global settings only.

Setting	What it does
Question UI mode	editor replaces the input area; overlay uses a floating popup.
Overlay popup width	Overlay mode only.
Overlay popup max height	Overlay mode only. Number or percentage string.
Visible option rows	Rows shown before scrolling.
Default question header	Fallback title when a request has no header.
Bridge replies enabled	Allow pi-session-bridge to answer/reject pending questions.

Glyph style: each package exposes glyphStyle (unicode default, ascii for terminal-safe chrome). @vanillagreen/pi-tool-renderer.globalGlyphStyleOverride=ascii forces ASCII chrome across vstack Pi extensions while leaving tool/model/user content unchanged.

Bridge control

Requires pi-session-bridge. From any shell:

pi-bridge questions
pi-bridge answer --request-id que_example --answers '[["Stop here"]]'
pi-bridge reject --request-id que_example