pi-tab-focus

Crush-style fullscreen transcript focus mode for Pi

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-tab-focus

Package: pi-tab-focus
Version: 1.0.2
Published: Sep 24, 2026
Downloads: 232/mo · 9/wk
Author: philvernon
License: ISC
Types: extension
Size: 108.5 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

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