pi-statusline

A command-driven statusline extension for pi with a Claude Code-compatible input payload.

Reuse your existing Claude Code statusline scripts in pi.

English | 简体中文

Compatible with Claude Code statusline scripts. You can usually reuse existing Claude Code statusline commands in pi with little or no modification.

Goals

• Reuse existing Claude Code statusline scripts where practical
• Feed a Claude-like JSON payload to an external command over stdin
• Render the command output in pi using a footer or a widget
• Refresh on session and turn boundaries with debounce and cancellation

Compatibility

This extension is designed to be compatible with the Claude Code statusline workflow:

• accepts a Claude Code-compatible statusline command
• sends a Claude-like JSON payload to the command via stdin
• makes it easier to migrate existing Claude Code statusline scripts to pi

If you already have a Claude Code statusline script such as ~/.claude/statusline.sh, you can usually point pi to the same script directly.

Installation

Install from npm in pi

pi install npm:pi-statusline

Install locally for development

Option 1: project-local extension

Copy or symlink this project into:

.pi/extensions/pi-statusline/

Option 2: package-based install

This package exposes its extension entry via:

{
  "pi": {
    "extensions": ["./src/index.ts"]
  }
}

Example pi settings

Add a statusLine block to your pi settings:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

Defaults:

• placement: footer
• padding: 0
• widgetPlacement: belowEditor
• debounceMs: 300
• timeoutMs: optional, disabled by default

Refresh model

The extension refreshes on:

• session_start
• turn_end
• model_select
• session_compact
• session_tree

UI integration

The extension uses ctx.ui.setFooter() or ctx.ui.setWidget() depending on configuration.

Current payload support

Implemented now:

• cwd
• session_id
• model
• workspace
• context_window
• exceeds_200k_tokens

Stubbed as null for now:

• transcript_path
• version
• cost
• rate_limits
• vim
• agent
• worktree

Development notes

This project is intentionally source-first. pi loads TypeScript extensions directly, so there is no build step in the initial scaffold.