@joyanhui/pi-ext-float-term

Pi coding agent extension — floating terminal overlay (fish, lazygit, yazi) powered by node-pty

Package details

extension

Install @joyanhui/pi-ext-float-term from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@joyanhui/pi-ext-float-term

Pi manifest JSON

{
  "extensions": [
    "./float-term.ts"
  ]
}

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

A pi extension providing floating terminal overlays powered by node-pty. Similar to Neovim's <leader>ft floating terminal.

Floating system shell — Ctrl+Alt+S opens the system default shell in an overlay
- Windows: FLOAT_TERM_SHELL, then ComSpec/COMSPEC, finally cmd.exe
- Unix: FLOAT_TERM_SHELL, then SHELL, finally /bin/sh
Floating lazygit — Ctrl+Alt+G opens lazygit in a floating terminal
Floating yazi — Ctrl+Alt+Y opens the yazi file manager
Exit gracefully — exit / Ctrl+D quits the shell and auto-closes; Ctrl+Space force-closes

pi install npm:@joyanhui/pi-ext-float-term

Or for a single session:

pi -e npm:@joyanhui/pi-ext-float-term

pi coding agent (v0.x+)
node-pty is an optional native dependency; Linux requires python3, make, and g++.
Install it with npm install -g --allow-scripts=node-pty node-gyp node-pty.
With pnpm, run pnpm approve-builds, approve node-pty, then run pnpm rebuild node-pty.
If needed, set FLOAT_TERM_NODE_PTY to its package directory and restart pi:

export FLOAT_TERM_NODE_PTY="$(npm root -g)/node-pty"

Command	Description
`/float-fish`	Open floating fish terminal
`/float-lazygit`	Open floating lazygit
`/float-yazi`	Open floating yazi file manager

Shortcut	Action
`Ctrl+Alt+S`	Floating system default shell
`Ctrl+Alt+G`	Floating lazygit
`Ctrl+Alt+Y`	Floating yazi

MIT