pi-shannon-statusline

Cyberpunk terminal HUD for Pi — ported from shannon-statusline for Claude Code

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-shannon-statusline

Package: pi-shannon-statusline
Version: 1.1.1
Published: Sep 13, 2026
Downloads: 428/mo · 355/wk
Author: alexandre_ai
License: MIT
Types: extension
Size: 276.2 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "image": "https://raw.githubusercontent.com/RealAlexandreAI/pi-shannon-statusline/master/shannon-statusline.png"
}

Security note

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

README

Install

pi install npm:pi-shannon-statusline

From a checkout:

git clone https://github.com/RealAlexandreAI/pi-shannon-statusline.git
cd pi-shannon-statusline
pi install .

HUD

The extension renders below the editor:

⌘ ~/D/project  │  ⎇ main* ↑2 !3 +1  │  ↺ loop ×12  │  ↑ 36k  │  ✦ 12m
λ deepseek / deepseek-v4-pro  │  ⊡ ████████░░░░ 65% (200k)
» TTFT 1.24s  │  Decode ~42.1 tok/s · ~312 tok
※ ×3 AGENTS.md  │  ⊕ ×4 MCPs  │  ★ ×5 Skills
─────────────────────────────────────────────────────────────
✔ read ×12  │  ✔ edit ×7  │  ✔ bash ×4
↻ bash: src/index.ts (3s)
─────────────────────────────────────────────────────────────
↻ agent (3s)  │  ✔ agent ×2

Configuration

Optional file: ~/.pi/agent/shannon-statusline.json

{
  "rain": true,
  "rainChars": "0123456789λΨΩΔΦ",
  "footer": false,
  "throughput": true
}

Option	Type	Default	Effect
`rain`	boolean	`true`	Show the matrix column.
`rainChars`	string	built-in set	Characters used by the matrix column.
`footer`	boolean	`true`	Show Pi's built-in footer and extension status rows.
`throughput`	boolean	`true`	Show response metrics on line 3.

Configuration is read on every HUD refresh. footer: false hides Pi's footer without hiding the Shannon HUD.

Metrics

TTFT: time from before_provider_request to the first assistant delta.
Decode: client-observed output rate; ~ marks an estimate.
Input/TTFT: client-side input rate estimate.

Requirements

Pi >= 0.84.4.

Development

node --test src/__tests__/*.ts

License

MIT