pi-execution-time 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lukas Panni
+
+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.

package/README.md

@@ -0,0 +1,62 @@
+# pi-execution-time
+
+[pi](https://github.com/badlogic/pi-mono) package that adds a live task execution timer to the footer.
+
+The timer starts when a prompt begins running and counts up until the agent finishes. It renders as a compact status item in the bottom bar next to pi's built-in cost and context usage indicators.
+
+## Install
+
+From GitHub:
+
+```bash
+pi install https://github.com/lukaspanni/pi-execution-time
+```
+
+From npm after publishing:
+
+```bash
+pi install npm:pi-execution-time
+```
+
+## Usage
+
+Reload or restart pi after installation. When the agent is working, the footer shows a live timer:
+
+```text
+⏱ 4.2s
+```
+
+When the agent finishes, it keeps the final duration visible:
+
+```text
+✓ task 18s
+```
+
+Longer durations are formatted as `1m 05s` or `1h 02m 03s`.
+
+## Local development
+
+```bash
+npm install
+npm run validate
+pi -e ./extensions/execution-time.ts
+```
+
+## Package contents
+
+- `extensions/execution-time.ts` - registers the footer status timer
+
+## Publishing
+
+The included GitHub Actions workflow publishes on `v*` tags or manual dispatch:
+
+```bash
+npm version patch
+git push --follow-tags
+```
+
+Configure npm trusted publishing for this repository, or adapt `.github/workflows/publish.yml` to use `NODE_AUTH_TOKEN`.
+
+## License
+
+MIT

package/extensions/execution-time.ts

@@ -0,0 +1,86 @@
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+
+const STATUS_KEY = "execution-time";
+const UPDATE_INTERVAL_MS = 250;
+
+type TimerState = {
+	startedAt: number;
+	interval: ReturnType<typeof setInterval>;
+};
+
+export default function (pi: ExtensionAPI) {
+	let timer: TimerState | undefined;
+
+	function stopTimer() {
+		if (!timer) return;
+		clearInterval(timer.interval);
+		timer = undefined;
+	}
+
+	function renderRunning(ctx: ExtensionContext) {
+		if (!timer) return;
+		const elapsedMs = Date.now() - timer.startedAt;
+		const icon = ctx.ui.theme.fg("accent", "⏱");
+		const text = ctx.ui.theme.fg("dim", ` ${formatElapsed(elapsedMs)}`);
+		ctx.ui.setStatus(STATUS_KEY, icon + text);
+	}
+
+	function renderDone(ctx: ExtensionContext, elapsedMs: number) {
+		const icon = ctx.ui.theme.fg("success", "✓");
+		const label = ctx.ui.theme.fg("dim", " task ");
+		const value = ctx.ui.theme.fg("muted", formatElapsed(elapsedMs));
+		ctx.ui.setStatus(STATUS_KEY, icon + label + value);
+	}
+
+	pi.on("agent_start", async (_event, ctx) => {
+		stopTimer();
+
+		timer = {
+			startedAt: Date.now(),
+			interval: setInterval(() => renderRunning(ctx), UPDATE_INTERVAL_MS),
+		};
+
+		renderRunning(ctx);
+	});
+
+	pi.on("agent_end", async (_event, ctx) => {
+		if (!timer) return;
+
+		const elapsedMs = Date.now() - timer.startedAt;
+		stopTimer();
+		renderDone(ctx, elapsedMs);
+	});
+
+	pi.on("session_shutdown", async (_event, ctx) => {
+		stopTimer();
+		ctx.ui.setStatus(STATUS_KEY, undefined);
+	});
+}
+
+function formatElapsed(ms: number) {
+	const totalSeconds = Math.max(0, ms / 1000);
+
+	if (totalSeconds < 10) {
+		return `${totalSeconds.toFixed(1)}s`;
+	}
+
+	const roundedSeconds = Math.floor(totalSeconds);
+	const seconds = roundedSeconds % 60;
+	const totalMinutes = Math.floor(roundedSeconds / 60);
+	const minutes = totalMinutes % 60;
+	const hours = Math.floor(totalMinutes / 60);
+
+	if (hours > 0) {
+		return `${hours}h ${pad2(minutes)}m ${pad2(seconds)}s`;
+	}
+
+	if (minutes > 0) {
+		return `${minutes}m ${pad2(seconds)}s`;
+	}
+
+	return `${roundedSeconds}s`;
+}
+
+function pad2(value: number) {
+	return value.toString().padStart(2, "0");
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "pi-execution-time",
+  "version": "0.1.0",
+  "description": "Pi extension that shows prompt execution time in the footer while the agent works.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lukaspanni/pi-execution-time"
+  },
+  "author": {
+    "name": "Lukas Panni",
+    "url": "https://github.com/lukaspanni"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "timer",
+    "execution-time"
+  ],
+  "files": [
+    "extensions",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "pack:check": "npm pack --dry-run",
+    "validate": "npm run typecheck && npm run pack:check"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*"
+  },
+  "devDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "typescript": "^5.9.3"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
+  }
+}