pi-quote-blocks

Codex-style quote blocks for Pi: select a passage, get a block card above the editor, expand on submit

Packages

Package details

extension

Install pi-quote-blocks from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-quote-blocks

Package: pi-quote-blocks
Version: 0.2.2
Published: Nov 1, 2026
Downloads: 494/mo · 494/wk
Author: codelllc09
License: MIT
Types: extension
Size: 50.9 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./quote-blocks.ts"
  ]
}

Security note

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

README

English · 简体中文

pi-quote-blocks

Select any passage of a reply and respond to just that part — Codex-style quote blocks, entirely in the terminal.

❝ Q1 · 3 lines
│ The cache should expire after 24 hours.
│ … +1 more
❝ Q2 · 1 line
│ switch to docker compose deploy
──────────────────────────────────────────────
❯ [Q1] is this right? [Q2] and this?

Install

pi install npm:pi-quote-blocks

Or from source: pi install git:github.com/codelllc09/pi-quote-blocks

Usage

Action	Effect
Drag-select transcript + `Alt+Q`	Quote it; `[Qn]` lands at the cursor
`Alt+Q` without a selection	Falls back to the clipboard (pi's copy-on-select keeps it in sync)
`/quote [n]`	Quote the nth-last assistant reply (default: last)
`Alt+E`	Block manager — docked window, live preview; `e` edit · `r` remove · `i` insert marker · Enter for more
`Alt+H`	Fold / expand cards
Submit	Markers expand to `> quotes`; unreferenced blocks are dropped

/quotes opens the same manager (subcommands: clear fold unfold edit Qn remove Qn preview). Cards render above the editor while you compose; delete a [Qn] marker and its card disappears. Numbering restarts at Q1 per batch.

Configuration

Env	Default	Meaning
`PI_QUOTE_KEY_QUOTE` · `_FOLD` · `_MANAGE`	`alt+q` · `alt+h` · `alt+e`	Key(s) per action; comma-separated lists bind several keys
`PI_QUOTE_FOLD_LINES`	`8`	Auto-fold beyond this many card lines
`PI_QUOTE_CLIPBOARD`	on	`=0` disables the clipboard fallback
`PI_QUOTE_ALLOW_UNREVIEWED`	off	`=1` skips the reviewed-version allowlist
`PI_QUOTE_DEBUG` / `PI_QUOTE_DEBUG_LOG`	off / `/tmp/quote-blocks-debug.log`	Debug log

Keys use pi's key-id format; set them per terminal (WezTerm pane env, direnv, …) when a default collides. alt+shift+<letter> matches no encoding in pi-tui 1.4.0 and warns at startup.

How it works

Terminal editors are plain text grids, so no inline floating blocks:

Cards render in the widget area above the editor
The draft holds only short [Qn] markers — position = quote anchor
On submit an input-event transform expands markers to Markdown quotes (> …), blank-line padded so lazy continuation cannot swallow your annotations

Compatibility

Live selection reads renderer internals, gated by REVIEWED_PI_VERSIONS (1.0.3, 1.4.0); everything else — and regular (non-fullscreen) mode — uses the public clipboard path instead (pbpaste / xclip / xsel / wl-paste / termux-clipboard-get / Get-Clipboard).

Development

npm install && npm run typecheck && npm test

Credits

Selection acquisition (the widget-bridge trick and API probing) derives from alandarev/pi-quote v0.1.2 (MIT); the block architecture, marker expansion, and folding are this repo's work. See LICENSE.