pi-tab-focus1.0.2
Crush-style fullscreen transcript focus mode for Pi
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
pi-tab-focus
Crush-style transcript focus mode for Pi. Navigate, select and copy transcript content without leaving the terminal.
Install
pi install npm:pi-tab-focus
Run Pi in fullscreen mode:
pi --tui-mode fullscreen
pi-vim
pi-tab-focus works with Pi's built-in editor and supports pi-vim. If you use both, install pi-vim first:
pi install npm:pi-vim
pi install npm:pi-tab-focus
The same ordering should be used in settings.json.
Usage
Press Tab to enter transcript focus. Press Tab or Esc to return to the editor.
| Key | Action |
|---|---|
j / ↓ |
scroll down |
k / ↑ |
scroll up |
u / d |
half-page up / down |
Shift+J / Shift+↓ |
next transcript item |
Shift+K / Shift+↑ |
previous transcript item |
b / PgUp |
page up |
f / PgDn |
page down |
g / Home |
top |
G / End |
bottom |
y / c |
copy selected item or visual selection |
v |
visual cursor / character selection |
V |
line selection |
Enter |
open the first link in the selected item; in visual mode, open the link under the cursor |
: |
open EX mode when using pi-vim |
Ctrl+O |
toggle tool output |
Ctrl+T |
toggle thinking visibility |
Ctrl+C |
return to editor focus |
Ctrl+D |
shut down Pi |
Visual mode supports familiar Vim-style navigation including h/j/k/l, word motions, counts, f/F/t/T, gg/G, paragraph motions and common text objects such as iw, aw and quoted/bracketed selections.
Configuration
Tab is the default focus key. To change it globally, create ~/.pi/agent/pi-tab-focus.json:
{
"focusKey": "f6",
"hideDefaultScrollIndicator": true
}
A trusted project can override this with .pi/pi-tab-focus.json. Use Pi's normal key format and run /reload after changing the config.
Prefer modifier or function-key bindings for focusKey (for example ctrl+g or f6). An unmodified printable key such as f will intercept normal typing while Pi is in fullscreen mode.
Set hideDefaultScrollIndicator to false if you want to keep Pi's built-in "Jump to latest message" indicator.
Compatibility
Tested with Pi 0.85.1.
Optional pi-vim integration is tested with pi-vim 0.14.2.
Development
npm ci
npm run typecheck
npm test
npm pack --dry-run