pi-herdr-cursor-focus

Pi extension that hides the editor cursor in unfocused herdr panes

Packages

Package details

extension

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

npm report
$ pi install npm:pi-herdr-cursor-focus
Package
pi-herdr-cursor-focus
Version
0.1.0
Published
Jul 21, 2026
Downloads
164/mo · 14/wk
Author
gogamid
License
MIT
Types
extension
Size
10 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.js"
  ]
}

Security note

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

README

pi-herdr-cursor-focus

A Pi extension that hides the editor cursor in unfocused herdr panes.

Wraps the active Pi editor instead of replacing it, so it works alongside other editor/status extensions.

What it does

  • Detects the current HERDR_PANE_ID.
  • Polls herdr pane current every 500ms to check focus state.
  • Hides Pi's fake editor cursor when the pane loses focus.
  • Restores the cursor when focus returns.
  • Keeps any existing editor wrapper instead of replacing it.

Requirements

  • Running inside herdr (HERDR_ENV=1).
  • herdr binary available in PATH.

Installation

pi install npm:pi-herdr-cursor-focus

Configuration

No configuration needed. The extension activates automatically when running inside a herdr pane.

How it works

Pi draws a fake cursor in the TUI to show the text input position. When your herdr pane isn't focused, seeing that cursor can be misleading. This extension polls herdr pane current every 500ms, and when the pane loses focus, it strips the cursor rendering from the editor output. When focus returns, the cursor reappears.

The wrapper approach means your existing editor extensions and customizations continue to work.

License

MIT