# Pi Station bar
Custom status bar extension for [pi](https://github.com/badlogic/pi-mono) with fixed editor layout, bash mode, editor stash, prompt history, undo/redo, hashline read/edit tools, and configurable segments.
## Demo
https://github.com/user-attachments/assets/27e9beca-35e2-4491-9cc2-c3b70203ceca
## Install
```bash
pi install npm:@nielpattin/pi-station
```
Restart pi to activate.
## Commands
| Command | What |
| ---------------- | -------------------------------------------------------------- |
| `/station` | Open station bar settings (fixed editor, scroll bar, hashline) |
| `/stash-history` | Open prompt history picker |
| `/bash-mode` | Enable sticky bash mode |
| `/bash-reset` | Reset managed bash session |
Station bar runs as a custom editor with fixed layout compositor. Configure via `/station` settings menu or `settings.json`.
```json
{
"station": {
"fixedEditor": true,
"scrollBar": true,
"hashline": true
}
}
```
When `fixedEditor` is enabled (default): chat/feed scrolls above a fixed cluster containing station bar, editor, bash transcript, and last-prompt display. Uses the terminal's alternate screen buffer for composited scrolling.
You can select chat text and continue scrolling the chat viewport with the mouse wheel while keeping the selection active. Mouse selection now copies only visible chat text, not trailing padding cells.
When disabled: station bar widgets attach to pi's regular TUI layout using `aboveEditor`/`belowEditor` placements.
`scrollBar` shows a scroll position indicator on the right edge of the fixed cluster.
## Shortcuts
Defaults:
| Shortcut | What |
| ------------ | -------------------------- |
| `Ctrl+B` | Toggle bash mode |
| `Alt+S` | Stash/restore editor text |
| `Ctrl+Alt+H` | Open prompt history picker |
| `Ctrl+Z` | Undo editor input |
| `Ctrl+Y` | Redo editor input |
Override in `settings.json`:
```json
{
"station": {
"shortcuts": {
"bashMode": "ctrl+shift+b",
"stash": "ctrl+shift+s",
"stashHistory": "ctrl+shift+h",
"undo": "ctrl+z",
"redo": "ctrl+y"
}
}
}
```
## Undo/Redo
`Ctrl+Z` undoes the last edit in the prompt editor. `Ctrl+Y` redoes it. Both keys are configurable via `shortcuts.undo` and `shortcuts.redo` in station settings.
- `Ctrl+Z` also works alongside pi's built-in `Ctrl+-` undo.
- `Ctrl+Y` overrides pi's yank (kill-ring paste). If you need yank, remap `redo` to a different key.
- The redo stack is cleared when you make a new edit after undoing (standard undo/redo semantics).
## Hashline
Hashline replaces pi's built-in `read` and `edit` tools with hash-anchor-based versions. File lines are tagged with `LINE#HASH` anchors that survive edits, so the agent can reference exact lines without line-number drift.
- **Read tool**: Returns file content with `LINE#HASH` anchors, width-aware path truncation, and opencode-style arrow rendering (`-> Read :range`).
- **Edit tool**: Uses hash anchors to locate edit targets. Supports exact-match replace, line-range replace, and legacy top-level replace. Generates diffs and returns changed regions.
Toggle via `/station` settings or `settings.json`:
```json
{
"station": {
"hashline": true
}
}
```
Default is `true`. When disabled, pi's built-in read/edit tools are used instead.
## Editor Stash
`Alt+S` toggles editor stash by default:
| Editor | Stash | Result |
| -------- | --------- | -------------------------- |
| Has text | Empty | Stash text, clear editor |
| Empty | Has stash | Restore stash into editor |
| Has text | Has stash | Update stash, clear editor |
| Empty | Empty | Nothing to stash |
Stashed text auto-restores when agent finishes if editor is still empty. Stash history persists to `~/.pi/agent/station-bar/stash-history.json` (up to 12 entries).
## Prompt history
Open with `Ctrl+Alt+H` by default or `/stash-history`. Two sources:
- **Stashed prompts** — up to 12 recent stashed entries (newest first)
- **Recent project prompts** — up to 50 user prompts from pi sessions in current project folder
Selecting an entry with existing editor text offers Replace, Append, or Cancel.
## Bash mode
Enter with `/bash-mode` or `Ctrl+B` by default. Exit with `Escape` or the bash-mode shortcut again. Persistent shell session per pi session. Ghost-first completions from project shell history, global history, git, path, and executable sources.
While active:
- **Enter** runs current shell command
- **Right Arrow** accepts ghost text without running
- **Tab** accepts ghost suggestion if one exists
- **Up/Down** browse matching shell history
- **Escape** exits bash mode
- **Ctrl+C** interrupts active shell job
Command output renders in full-screen overlay (fixed-editor mode) or widget (non-fixed-editor). Shell cwd changes reflect in the `shell_mode` segment.
### One-off bash commands
`!command` and `!!command` prompts reuse the shell prediction pipeline, including ghost suggestions.
### Bash mode settings
```json
{
"bashMode": {
"transcriptMaxLines": 2000,
"transcriptMaxBytes": 524288
}
}
```
## Station bar layout
| Row | Left | Right |
| --------- | -------------------------------------------------------------- | ------------------- |
| Primary | `path`, `git` | `mcp`, `skills` |
| Secondary | `shell_mode`, `context_pct`, `cache_read`, `cache_hit`, `cost` | `model`, `thinking` |
| Tertiary | `extension_statuses` | |
### Custom items
Register custom status items from any extension via config:
```json
{
"station": {
"customItems": [
{
"id": "ci",
"statusKey": "ci-status",
"position": "right",
"prefix": "CI",
"color": "warning"
}
]
}
}
```
Fields: `id` (required, `[a-zA-Z0-9_-]+`), `statusKey` (defaults to `id`), `position` (`left`/`right`/`secondary`, default `right`), `prefix`, `color` (pi theme color or `#RRGGBB`), `hideWhenMissing` (default `true`), `excludeFromExtensionStatuses` (default `true`).
## Configuration
Settings merge from `~/.pi/agent/settings.json` and project `.pi/settings.json`:
```json
{
"station": {
"fixedEditor": true,
"scrollBar": true,
"hashline": true,
"customItems": [],
"shortcuts": {
"bashMode": "ctrl+b",
"stash": "alt+s",
"stashHistory": "ctrl+alt+h",
"undo": "ctrl+z",
"redo": "ctrl+y"
}
},
"showLastPrompt": true,
"bashMode": {
"transcriptMaxLines": 2000,
"transcriptMaxBytes": 524288
}
}
```
## Segments
Built-in segments: `model`, `shell_mode`, `path`, `git`, `subagents`, `token_in`, `token_out`, `token_total`, `cost`, `context_pct`, `context_total`, `time_spent`, `time`, `session`, `hostname`, `cache_read`, `cache_write`, `cache_hit`, `thinking`, `extension_statuses`, `skills`, `mcp`.
**Thinking** segment shows current thinking level (`think:off`, `think:med`, etc.) with per-level colors.
**Git** integration uses async cached fetching (1s TTL). Invalidates on file writes/edits and git branch-changing commands. Shows branch, staged (+), unstaged (\*), untracked (?).
**Context** warning colors: yellow at 70%, red at 90%. During streaming, uses live assistant usage. When `pi-custom-compaction` is installed, native context segments are hidden to avoid stale post-summary usage display.
**Cache hit** (`cache_hit`) shows the latest message cache hit rate as `CH%`. Uses `latestCacheHitRate` from usage stats, matching pi's built-in footer display.
**Subscription** detected via OAuth model registry — shows `(sub)` instead of dollar cost.
## Credits
Thanks for the solution for the fixed input from Nico https://github.com/nicobailon/pi-interactive-shell
## License
MIT