pi-annotated-reply

Adds an annotated-reply workflow to pi. Construct prompts by annotating either the last model response, a file, or the current uncommitted git diff. Annotated text is loaded into pi’s main editor, ready to submit as your next prompt. Source files are never modified.

Commands

| Command | Description | |---------|-------------| | /reply | Annotate the last model response | | /reply <path> | Annotate a file (including saved .diff / .patch files; original file is not changed) | | /reply --raw | Load raw content into editor without annotation header | | /reply --diff | Collect uncommitted git changes (staged + unstaged + untracked text files) from the repo containing the current working directory | | /reply-editor | Same as /reply, but opens in your external editor ($VISUAL/$EDITOR) | | /reply-editor <path> | Same as /reply <path>, but opens in your external editor | | /load-content | Alias for /reply --raw | | /load-content <path> | Alias for /reply <path> --raw | | /load-content-editor | Alias for /reply-editor --raw | | /load-content-editor <path> | Alias for /reply-editor <path> --raw | | /reply-diff | Review uncommitted git changes in annotation format | | /reply-diff-editor | Review uncommitted git changes in external editor | | /annotated-reply | Alias for /reply | | /annotated-reply <path> | Alias for /reply <path> | | /annotated-reply-editor | Alias for /reply-editor | | /annotated-reply-editor <path> | Alias for /reply-editor <path> | | /annotated-reply-diff | Review uncommitted git changes in annotation format | | /annotated-reply-diff-editor | Review uncommitted git changes in external editor |

All commands accept:

• --raw to skip the annotation header and load bare content into the editor.
• --diff to collect the current repo diff against HEAD (tracked staged + unstaged changes) plus untracked text files from the repo containing the current working directory.
• With --raw --diff, the raw diff is loaded into the editor without the annotation template.
• With annotated mode (no --raw), repo diffs and saved .diff / .patch files are wrapped in a fenced diff block for syntax-highlighted markdown rendering.
• When --diff is provided, path arguments are rejected with a warning. To annotate a saved diff file, use /reply <path> or /reply-editor <path> instead.
• Saved .diff / .patch files can still be annotated via /reply <path> or /reply-editor <path>.

Prefill format

The extension prefills content like:

annotated reply below:
original source: last model response
user annotation syntax: [an: note]

---

<model response content>

or

annotated reply below:
original source: file ./path/to/file.ts
user annotation syntax: [an: note]

---

<file content>

or

annotated reply below:
original source: git diff HEAD (2 files changed, 15 insertions(+), 3 deletions(-), 1 untracked file)
user annotation syntax: [an: note]

---

~~~diff
diff --git a/src/index.ts b/src/index.ts
...
~~~

Annotation style (suggested)

A simple default is [an: note], inline with the source text.

This is only a suggested pattern, not a strict format. Use whatever annotation style is clear for your workflow.

Install

pi install npm:pi-annotated-reply

Or from git:

pi install https://github.com/omaclaren/pi-annotated-reply

Or run directly:

pi -e https://github.com/omaclaren/pi-annotated-reply

Notes

• If $VISUAL/$EDITOR is not set, *-editor commands automatically fall back to pi's built-in extension editor.
• If the latest assistant message is incomplete or has no text content, reply-based commands show a warning.
• File annotation reads the selected file content and injects an editable copy into the editor. The source file is never modified by this extension.
• If --diff is used outside a git repo, the command shows a warning.
• If --diff finds no uncommitted changes, the command shows an info message.
• In a repo with no commits yet, --diff synthesizes reviewable “new file” diffs from the current tracked and untracked text files.

License

MIT