jb

0 Followers · 0 Following

• Joined on 2025-12-31

Repositories

12

Projects Packages Public Activity Starred Repositories

@jbcode/pi-prompt-snippets (0.1.0)

Published 2026-09-01 17:54:06 -04:00 by jb in jb/harness-tools

Installation

Set up this registry in your project .npmrc file:

@jbcode:registry=https://git.jb.codes/api/packages/jb/npm/

To install the package using npm, run the following command:

npm install @jbcode/pi-prompt-snippets@0.1.0

or add it to the package.json file:

"@jbcode/pi-prompt-snippets": "0.1.0"

For more information on the npm registry, see the documentation.

About this package

Pi extension for toggling reusable per-message prompt snippets.

Prompt Snippets

Mix-and-match single-purpose prompt rules that are prepended or appended to your message when you send it. Unlike skills, each snippet is a tiny, standalone instruction — toggle exactly the ones you want per message.

Usage

• Press alt+s or run /snippets to open the toggle menu.
  • up/down to navigate, space to toggle, enter to apply, esc to cancel.
  • tab previews the highlighted snippet (name, placement, order, filename, and full body; up/down scroll long bodies). tab or esc returns to the list with your cursor position preserved.
  • The menu is framed with top/bottom border lines and scrolls when the list exceeds the viewport (max height adapts to your terminal), with ↑ n more / ↓ n more indicators when clipped.
• Active snippets show up as a widget above the editor:
  • ↑ prepend: ... (accent color) — inserted before your message
  • ↓ append: ... (warning color) — inserted after your message
• When you send a message, active snippet bodies are merged into the message text: prepend group (sorted by order) → your text → append group (sorted by order), separated by blank lines.
• Toggles reset to all off after each send and at session start.

Snippet files

Snippets live in snippets/ next to index.ts — one markdown file each, with frontmatter:

---
name: Concise
description: Keep answers short and to the point
placement: prepend
order: 10
---
Keep your response concise. Skip preamble and unnecessary explanation.

Field	Required	Notes
name	no	Display name; defaults to the filename without .md
description	no	Shown next to the name in the toggle menu
placement	no	prepend or append (default: append)
order	no	Number; sorts snippets within their group, in the menu and in the applied text (default: 9999, ties broken by name)

Files are re-scanned every time the menu opens and every time a message is sent, so edits take effect immediately — no /reload needed.

Dependencies

Peer Dependencies

ID	Version
@earendil-works/pi-coding-agent	*
@earendil-works/pi-tui	*

Keywords

pi-package pi-extension prompts

Details

npm

jb/harness-tools

2026-09-01 17:54:06 -04:00

4

MIT

latest

6.6 KiB

Assets (1)

pi-prompt-snippets-0.1.0.tgz 6.6 KiB

Versions (1) View all

0.1.0 2026-09-01

Issues