Merge pull request #6 from narumiruna/feat/pi-statusline

feat(statusline): add customizable footer extension

Author: narumiruna

AGENTS.md

@@ -15,8 +15,8 @@ Run commands from the repository root unless noted otherwise.
 - Full verification: `npm run check` or `just check`
 - Format with Biome: `npm run format` or `just format`
 - Typecheck all workspaces: `npm run typecheck`
-- Preview npm package contents: `just pack-caffeinate`, `just pack-chrome-devtools`, `just pack-firecrawl`, `just pack-goal`, `just pack-python-lsp`, or `just pack-retry`
-- Try a local extension without installing: `just try-caffeinate`, `just try-chrome-devtools`, `just try-firecrawl`, `just try-goal`, `just try-python-lsp`, or `just try-retry`
+- Preview npm package contents: `just pack-caffeinate`, `just pack-chrome-devtools`, `just pack-firecrawl`, `just pack-goal`, `just pack-python-lsp`, `just pack-retry`, or `just pack-statusline`
+- Try a local extension without installing: `just try-caffeinate`, `just try-chrome-devtools`, `just try-firecrawl`, `just try-goal`, `just try-python-lsp`, `just try-retry`, or `just try-statusline`
 - Inspect available recipes before adding new workflow commands: `just --list`
 
 ## Code style

MEMORY.md

@@ -7,6 +7,8 @@
 - For sleep-inhibitor extensions on WSL, prefer Windows `powershell.exe` with `SetThreadExecutionState`; `systemd-inhibit` may exist but fail without a usable systemd/logind session.
 - When testing TypeScript extensions via direct Node import, avoid parameter properties; Node's strip-only TypeScript loader rejects them even though `tsc` accepts them.
 - ty/ruff LSP servers may request `workspace/configuration`; respond with per-item empty config objects or diagnostic requests can hang.
+- pi-statusline is display-only; avoid prompt interception or customization commands unless intentionally reintroduced.
+- In Pi extensions, do not call action methods such as `getThinkingLevel()` during the factory load; defer them to `session_start` or later handlers.
 
 ## TASTE
 

README.md

@@ -12,6 +12,7 @@ Monorepo for independently installable Pi extension packages.
 | `@narumitw/pi-goal` | [`extensions/pi-goal`](./extensions/pi-goal) | `pi install npm:@narumitw/pi-goal` |
 | `@narumitw/pi-python-lsp` | [`extensions/pi-python-lsp`](./extensions/pi-python-lsp) | `pi install npm:@narumitw/pi-python-lsp` |
 | `@narumitw/pi-retry` | [`extensions/pi-retry`](./extensions/pi-retry) | `pi install npm:@narumitw/pi-retry` |
+| `@narumitw/pi-statusline` | [`extensions/pi-statusline`](./extensions/pi-statusline) | `pi install npm:@narumitw/pi-statusline` |
 
 ## Local development
 
@@ -30,6 +31,7 @@ pi -e ./extensions/pi-firecrawl
 pi -e ./extensions/pi-goal
 pi -e ./extensions/pi-python-lsp
 pi -e ./extensions/pi-retry
+pi -e ./extensions/pi-statusline
 ```
 
 Preview package contents:
@@ -41,6 +43,7 @@ npm run pack:firecrawl
 npm run pack:goal
 npm run pack:python-lsp
 npm run pack:retry
+npm run pack:statusline
 ```
 
 Publish packages from their package directories:
@@ -52,4 +55,5 @@ cd extensions/pi-firecrawl && npm publish --access public
 cd extensions/pi-goal && npm publish --access public
 cd extensions/pi-python-lsp && npm publish --access public
 cd extensions/pi-retry && npm publish --access public
+cd extensions/pi-statusline && npm publish --access public
 ```

extensions/pi-statusline/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 narumiruna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

extensions/pi-statusline/README.md

@@ -0,0 +1,61 @@
+# pi-statusline
+
+A public [pi](https://pi.dev) extension package that replaces Pi's footer with a beautiful, information-rich statusline.
+
+## Install
+
+```bash
+pi install npm:@narumitw/pi-statusline
+```
+
+Try without installing:
+
+```bash
+pi -e npm:@narumitw/pi-statusline
+```
+
+Try this package locally from the repository root:
+
+```bash
+pi -e ./extensions/pi-statusline
+```
+
+## What it shows
+
+The default statusline includes:
+
+- `π` brand marker
+- current model
+- thinking level
+- git branch
+- current project directory
+- active or last tool
+- context usage percentage
+- token totals
+- estimated cost
+- clock
+
+Statuses from other extensions, such as goal mode, appear on their own line below the main statusline and are separated with ``.
+The layout adapts to terminal width and truncates safely.
+
+## Package layout
+
+```txt
+extensions/pi-statusline/
+├── src/
+│   └── statusline.ts
+├── README.md
+├── LICENSE
+├── tsconfig.json
+└── package.json
+```
+
+The package exposes its extension through `package.json`:
+
+```json
+{
+  "pi": {
+    "extensions": ["./src/statusline.ts"]
+  }
+}
+```

extensions/pi-statusline/package.json

@@ -0,0 +1,37 @@
+{
+	"name": "@narumitw/pi-statusline",
+	"version": "0.1.3",
+	"description": "Pi extension that replaces the footer with an information-rich statusline.",
+	"type": "module",
+	"license": "MIT",
+	"private": false,
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"pi",
+		"statusline",
+		"footer"
+	],
+	"files": [
+		"src",
+		"README.md",
+		"LICENSE"
+	],
+	"pi": {
+		"extensions": [
+			"./src/statusline.ts"
+		]
+	},
+	"scripts": {
+		"check": "biome check . && npm run typecheck",
+		"format": "biome check --write .",
+		"typecheck": "tsc --noEmit"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.4.14",
+		"@mariozechner/pi-coding-agent": "0.73.0",
+		"@mariozechner/pi-tui": "0.73.0",
+		"@types/node": "25.6.0",
+		"typescript": "6.0.3"
+	}
+}