pi-autosuggestions 0.7.5 → 0.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +25 -4
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -13,14 +13,16 @@ you type: !cd Desk
13
13
  you see: !cd Desktop/ ( dimmed "top/", first char is your blinking cursor )
14
14
  ```
15
15
 
16
+ ![Ghost completion schematic](https://raw.githubusercontent.com/0xPlayerOne/pi-autosuggestions/main/docs/assets/ghost-schematic.svg)
17
+
16
18
  ## Install
17
19
 
18
20
  ```bash
19
- pi install git:github.com/0xPlayerOne/pi-autosuggestions
20
- # or pinned:
21
- pi install git:github.com/0xPlayerOne/pi-autosuggestions@pi-autosuggestions-v0.2.1
22
- # or from npm:
23
21
  pi install npm:pi-autosuggestions
22
+ # or pinned:
23
+ pi install npm:pi-autosuggestions@0.7.6
24
+ # or from git:
25
+ pi install git:github.com/0xPlayerOne/pi-autosuggestions
24
26
  ```
25
27
 
26
28
  ## Configuration
@@ -145,6 +147,25 @@ setting (Warp: Settings → Appearance → Cursor → Blinking).
145
147
  A software beam cursor is kept as a fallback if the hardware cursor is
146
148
  unavailable.
147
149
 
150
+ ## Keybindings
151
+
152
+ | Keys | Action |
153
+ | --------------------- | ------------------------------ |
154
+ | `→` / `Tab` | Accept the whole suggestion |
155
+ | `Alt+f` / `Ctrl+→` | Accept one word |
156
+ | `Esc` | Dismiss until the next edit |
157
+ | `Alt+Down` / `Alt+Up` | Cycle multiple history matches |
158
+
159
+ ## Troubleshooting
160
+
161
+ | Symptom | Likely cause | Fix |
162
+ | ------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------- |
163
+ | No ghost appears | Nothing in history matches, or cursor left end-of-line | Type a prefix of a previous prompt; ghosts only show at end-of-line |
164
+ | Ghost shows in odd places | `updateGhost` runs on every render by design | `Esc` dismisses; it returns on your next edit |
165
+ | Cursor stays a block | Terminal ignores DECSCUSR / OSC 12 (e.g. Warp) | Check the terminal's cursor settings; the software beam fallback covers the rest |
166
+ | Broken after a pi update | Private pi-tui hooks drifted | Failures surface at startup — update the extension; types pin the breakage |
167
+ | Completions feel stale | Dynamic caches (branches, scripts, containers) live 10s | Wait a beat or retype; history ghosts are always live |
168
+
148
169
  ## Attribution
149
170
 
150
171
  This extension reimplements the interaction model of:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-autosuggestions",
3
- "version": "0.7.5",
3
+ "version": "0.7.7",
4
4
  "description": "zsh-autosuggestions-style ghost completions for the pi coding agent — history-based inline suggestions, path completion in bash mode, blinking beam cursor",
5
5
  "keywords": [
6
6
  "pi-package",