StickyBar

Input bar extension for pi coding agent.

Preview

Features

• Native Pi TUI — Pi owns the fixed editor, transcript scrolling, selection, and clipboard behavior in fullscreen mode
• Two configurable status rows with model, git state and more, check table below
• Last-prompt preview under the input prompt line
• Themed working vibes: generated realtime based on your input or loaded from a local file, with optional rainbow animation and character-by-character printing.

Installation

pi install npm:pi-stickybar

Restart pi after installation or call /reload.

Migrating to 3.0

StickyBar 3.0 removes its custom fixed-editor/transcript compositor. It no longer implements transcript scrolling, message navigation, mouse text selection, or clipboard copying. Pi owns those behaviors instead.

To retain a fixed editor and independently scrollable transcript, enable Pi's native fullscreen UI:

{
  "tuiMode": "fullscreen"
}

Remove these obsolete stickybar settings from existing configuration files; they are ignored by 3.0:

{
  "fixedEditor": true,
  "mouseScroll": true,
  "chatNavigation": {
    "previousKey": "ctrl+alt+up",
    "nextKey": "ctrl+alt+down"
  }
}

For fullscreen selections that should not copy terminal soft wraps as hard newlines, Pi does not yet expose source-wrap metadata. Install the optional pi-copy-soft-wrap Pi package; it normalizes copied fullscreen selections conservatively.

Configuration

The extension has opiniated defaults, but it also configurable via settings.json

Put settings under a single stickybar object. Pi reads global settings first, then project settings, so .pi/settings.json overrides ~/.pi/agent/settings.json.

Full configuration example:

{
  "stickybar": {
    "showLastPrompt": true,

    "top": [
      "git",
      "context_pct",
      "token_in",
      "token_out",
      "cost",
      "time_spent"
    ],

    "bottom": [
      "model",
      "thinking",
      "path",
      "extension_statuses"
    ],

    "options": {
      "path": { "mode": "basename", "maxLength": 32 },
      "git": {
        "polling": "full",
        "showBranch": true,
        "showStaged": true,
        "showUnstaged": true,
        "showUntracked": true
      },
      "time": { "format": "24h", "showSeconds": false }
    },

    "vibe": {
      "theme": "evil corporation",
      "mode": "generate",
      "model": "openai-codex/gpt-5.4-mini",
      "rainbow": true,
      "printing": true,
      "fallback": "Working",
      "refreshInterval": 30,
      "prompt": "Generate a {theme} loading message for: {task}. {exclude}",
      "maxLength": 65,
      "lookback": 30
    }
  }
}

Status items

top and bottom are ordered arrays. An item can appear only once, and unknown IDs are ignored.

| Item | Description | Example | | --- | --- | --- | | model | Current model in use | gpt-5.4-mini | | thinking | Reasoning/thinking level | medium | | path | Current file path (see options) | src/index.ts | | git | Git branch + working-tree state | main ⇡3 ✗2 ?1 | | context_pct | Context window usage percentage | 45% | | context_total | Total context tokens used | 12,450 tok | | token_in | Input tokens for current turn | 3,200 | | token_out | Output tokens for current turn | 840 | | token_total | Total tokens (in + out) | 4,040 | | cost | Estimated cost of current session | $0.012 | | time_spent | Elapsed time for current turn | 3s | | time | Current clock time | 14:35 | | session | Session identifier or name | sess-abc123 | | hostname | Machine hostname | my-laptop | | cache_read | Cache read hits | 128 | | cache_write | Cache write hits | 35 | | extension_statuses | All published extension statuses | ci: passing · deploy: ready |

Path options

Configure how file paths are displayed via options.path:

| Option | Values | Description | | --- | --- | --- | | mode | basename, abbreviated, full | How the path is rendered. basename shows only the filename (index.ts). abbreviated keeps the full path but truncates from the start with … when it exceeds maxLength. full always shows the complete absolute path. | | maxLength | number (default: 32) | Maximum length for abbreviated mode. Longer paths are truncated from the beginning and prefixed with …. |

Git polling options

Configure git status detail via options.git:

| Option | Values | Description | | --- | --- | --- | | polling | full, branch, off | How much git info to gather. full polls for branch name plus staged, unstaged, and untracked counts. branch shows only the current branch name without scanning working-tree changes. off skips local polling entirely and relies on whatever branch info pi provides. | | showBranch | boolean (default: true) | Include the branch name in the segment. | | showStaged | boolean (default: true) | Show the count of staged changes (⇡). | | showUnstaged | boolean (default: true) | Show the count of unstaged changes (✗). | | showUntracked | boolean (default: true) | Show the count of untracked files (?). |

Custom status items

Use custom:<id> in a row and declare the matching item in customItems:

{
  "stickybar": {
    "top": ["model", "path", "custom:ci", "git"],
    "bottom": ["context_pct", "extension_statuses"],
    "customItems": [
      {
        "id": "ci",
        "statusKey": "ci-status",
        "prefix": "CI",
        "hideWhenMissing": true,
        "excludeFromExtensionStatuses": true
      }
    ]
  }
}

Extensions publish a value with:

ctx.ui.setStatus("ci-status", "passing");

Native Pi fullscreen mode

StickyBar does not implement a transcript viewport, mouse selection, or clipboard copy path. Pi owns those concerns. To use a fixed editor with a scrollable transcript, enable Pi's native fullscreen TUI in the top-level Pi settings (outside the stickybar object):

{
  "tuiMode": "fullscreen",
  "stickybar": {
    "showLastPrompt": true
  }
}

Selection and clipboard behavior, including Pi's fullscreenCopyOnSelect setting and native copy keybinding, are managed only by Pi. StickyBar does not read, override, or document a preferred copy policy.

In Pi's regular mode, StickyBar renders its status widgets only; normal terminal scrollback and selection remain in control.

Working vibes

Manage vibes from pi with /stickybar vibe:

/stickybar                    Show current status
/stickybar vibe               Show vibe status
/stickybar vibe pirate        Enable a theme
/stickybar vibe off           Disable vibes
/stickybar vibe rainbow on    Enable rainbow animation
/stickybar vibe printing off  Disable character-by-character printing
/stickybar vibe mode file     Use ~/.pi/agent/vibes/<theme>.txt
/stickybar vibe model provider/model
/stickybar vibe generate evil cat corporation 100

generate mode requests a short message from the configured model while Pi is working. file mode rotates through messages in ~/.pi/agent/vibes/<theme>.txt and does not make a model request. Refreshed messages print character by character by default; set vibe.printing to false or run /stickybar vibe printing off to show them immediately.

In generate mode, the last lookback messages (default 30) are fed back to the model as an exclusion list to reduce repeats, and are persisted per-theme to ~/.pi/agent/vibes/<theme>.history.json so the exclusion list survives across sessions. Loading/saving this history is fire-and-forget and never blocks the UI. Set lookback to 0 to disable both the exclusion list and persistence.

This project is a rework of pi-powerline-footer with simplified approach to customization and limited feature list.