pi-zmx-status

A tiny Pi extension that shows the current zmx session name in Pi's status area.

When Pi is running inside zmx, zmx injects the ZMX_SESSION environment variable. This extension reads that variable and publishes a compact status value via ctx.ui.setStatus(). It does not change Pi's session display name.

Install

Install from npm with Pi's package installer:

pi install npm:@oleg_tarasov/pi-zmx-status

To pin a specific release:

pi install npm:@oleg_tarasov/pi-zmx-status@0.0.1

To try the package for a single run without adding it to settings:

pi -e npm:@oleg_tarasov/pi-zmx-status

After install, reload any running Pi session:

/reload

Usage

Start Pi inside zmx, for example:

zmx attach pi-1 pi

The Pi status area will show:

zmx:pi-1

If Pi is not running inside zmx, the extension clears its status entry.

Configuration

No configuration is required.

If you use pi-powerline-footer, this status appears through its normal extension-status support. You can also promote it as a custom powerline item using status key zmx.

Example ~/.pi/agent/settings.json snippet:

{
  "powerline": {
    "customItems": [
      {
        "id": "zmx",
        "statusKey": "zmx",
        "position": "right",
        "prefix": "zmx",
        "color": "accent"
      }
    ]
  }
}

Local development

For ad-hoc local use from a checkout:

pi --extension ./extensions/zmx-status.ts

Check syntax:

npm run check

License

MIT