@oldsuns/pi-sidebar

Floating right sidebar for pi with git diff/status and session metadata (unofficial fork of jrimmer/pi-sidebar).

Packages

Package details

extensionskill

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

npm repo home report

$ pi install npm:@oldsuns/pi-sidebar

Package: @oldsuns/pi-sidebar
Version: 0.2.2
Published: Jul 24, 2026
Downloads: 207/mo · 207/wk
Author: oldsuns
License: BSD-3-Clause
Types: extension, skill
Size: 137.8 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/sidebar.ts"
  ],
  "skills": [
    "./skills"
  ],
  "image": "https://raw.githubusercontent.com/OldSuns/pi-sidebar/main/assets/sidebar-screenshot.png"
}

Security note

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

README

@oldsuns/pi-sidebar

Floating right sidebar for the pi coding harness showing model, context, git, and session metadata. Unofficial fork of esso0428/pi-sidebar (which forked jrimmer/pi-sidebar).

Features

Floating right sidebar (default) or full-height fixed-window mode
Model + reasoning level, context usage, current branch + diff summary, per-file deltas
Auto-hide while the LLM is working
Custom data panels via sidebar-ui.json

Install

pi install npm:@oldsuns/pi-sidebar

From source:

git clone https://github.com/OldSuns/pi-sidebar
cd pi-sidebar
pi install ./

One-shot run without installing:

pi -e npm:@oldsuns/pi-sidebar

Reload after install inside pi:

/reload

Manage:

pi list
pi update --extensions
pi remove npm:@oldsuns/pi-sidebar

Commands

/sidebar — toggle visibility
/sidebar on|off|status|full|floating
/sidebar-refresh — refresh git/status data
/sidebar-git-detail — toggle changed-file list length
/sidebar-panels on|off — toggle panels compact mode
ctrl+shift+s — toggle sidebar

Custom Panels

Configure via ~/.pi/agent/sidebar-ui.json (global) or .pi/sidebar-ui.json (local):

{
  "panels": {
    "goal": {
      "label": "Goal",
      "entryType": "goal-state",
      "variables": {
        "goal.text": "Goal",
        "goal.status": "Status"
      }
    }
  }
}

Bundled skill pi-sidebar-ui-helper walks the LLM through config generation:

/skill:pi-sidebar-ui-helper

Environment Variables

Variable	Default	Description
`PI_SIDEBAR_ENABLED`	`1`	Start enabled.
`PI_SIDEBAR_WIDTH`	`34`	Sidebar content columns.
`PI_SIDEBAR_FULL_HEIGHT`	`0`	Use full-height mode.
`PI_SIDEBAR_MIN_TERM_WIDTH`	`110`	Auto-hide below this terminal width.
`PI_SIDEBAR_AUTOHIDE_WORKING`	`1`	Hide while the LLM is working.
`PI_SIDEBAR_REFRESH_MS`	`5000`	Git polling interval (ms).
`PI_SIDEBAR_GIT_LINES`	`12`	Max changed-file rows.
`PI_SIDEBAR_GIT_DETAIL`	`1`	Start with detailed changed-file list.

Git Data

Uses pi.exec to run static git commands (rev-parse, branch --show-current, diff --shortstat, status --porcelain=v1, diff --numstat HEAD --). No shell strings assembled from user input; only paths and diff counts are displayed.

Development

npm install --ignore-scripts
npm run verify

npm run verify runs typecheck, tests, and npm pack --dry-run.

Add a section by creating a renderer in extensions/sidebar/sections/<name>.ts and registering it in compositor.ts's buildSidebarContent.

License

BSD-3-Clause.