@alasano/pi-mouse

ASCII mouse that follows your cursor above the editor in pi

Package details

← Back

extension

Install @alasano/pi-mouse from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@alasano/pi-mouse

Package: @alasano/pi-mouse
Version: 0.1.0
Published: Apr 3, 2026
Downloads: 194/mo · 14/wk
Author: alasano
License: MIT
Types: extension
Size: 236.8 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ],
  "image": "https://raw.githubusercontent.com/alasano/house-of-pi/master/packages/pi-mouse/assets/pi-mouse.gif"
}

Security note

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

README

pi-mouse

An ASCII mouse that lives above your editor in pi. It follows your cursor as you type, scurrying left and right with an animated tail.

Install

pi install npm:@alasano/pi-mouse

Commands

Command	Description
`/cursor-mouse`	Toggle the mouse on or off
`/cursor-mouse on\|off`	Explicitly enable or disable

How it works

The mouse sits on a line above the editor. When you type, it debounces your cursor position and then walks toward it step by step. It faces the direction it's moving, and its tail wiggles as it goes. When idle, the tail still sways gently.

Requirements

Pi interactive mode (uses the custom editor API)