@tmustier/pi-usage-extension 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.9.1] - 2026-07-17
+
+### Changed
+- Exports now save to `/tmp` (or the OS temp dir where `/tmp` doesn't exist) instead of the pi session's cwd, so they never litter a repo or home directory. The `✓ Saved` note shows the full path.
+- The export directory is configurable: `{ "usage-extension": { "exportDir": "~/Downloads" } }` in `~/.pi/agent/settings.json` (`~` expands; the directory is created if missing).
+
 ## [0.9.0] - 2026-07-17
 
 ### Added

package/README.md

@@ -7,7 +7,7 @@ A Pi extension that displays aggregated usage statistics across all sessions.
 ## Compatibility
 
 - **Pi version:** 0.42.4+
-- **Last updated:** 2026-07-17 (0.9.0)
+- **Last updated:** 2026-07-17 (0.9.1)
 
 ## Installation
 
@@ -107,7 +107,7 @@ A note on reading them: cache-miss and context numbers are **observed cost, not
 
 ### Export
 
-Press `e` in any view to write the **current slice** to the current working directory:
+Press `e` in any view to write the **current slice** to `/tmp` (or the OS temp dir where `/tmp` doesn't exist) — exports never litter your repo or home directory, and the `✓ Saved` note shows the full path so you can grab the file if you want to keep it:
 
 | View | File | Contents |
 |---|---|---|
@@ -117,6 +117,14 @@ Press `e` in any view to write the **current slice** to the current working dire
 
 A `✓ Saved …` note confirms the write (or reports the error) above the help line.
 
+To export somewhere permanent instead, set an export directory in `~/.pi/agent/settings.json` (created if missing, `~` expands):
+
+```json
+{
+	"usage-extension": { "exportDir": "~/Downloads" }
+}
+```
+
 ### Graph explorer
 
 The **Graphs** view plots usage over time for the active period as a braille line chart, with a legend showing per-series totals and shares.

package/data.ts

@@ -198,7 +198,7 @@ export interface ParsedSessionFile {
 // Paths
 // =============================================================================
 
-function getAgentDir(): string {
+export function getAgentDir(): string {
 	// Replicate Pi's logic: respect PI_CODING_AGENT_DIR env var
 	return process.env.PI_CODING_AGENT_DIR || join(homedir(), ".pi", "agent");
 }

package/export.ts

@@ -7,9 +7,43 @@
  * component owns file naming and disk writes.
  */
 
+import { join } from "node:path";
 import type { Insight, ProviderStats, TotalStats } from "./data.ts";
 import type { GraphModel } from "./graph.ts";
 
+/**
+ * Read the configured export directory from settings.json content, if any.
+ * Config shape: `{ "usage-extension": { "exportDir": "~/Downloads" } }`.
+ */
+export function parseExportDirSetting(settingsJson: string): string | null {
+	try {
+		const parsed = JSON.parse(settingsJson) as { "usage-extension"?: { exportDir?: unknown } };
+		const dir = parsed["usage-extension"]?.exportDir;
+		return typeof dir === "string" && dir.trim() !== "" ? dir.trim() : null;
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Pick the export directory. A configured dir wins (with `~` expanded);
+ * otherwise exports go to /tmp so they never litter a repo or home
+ * directory, falling back to the OS temp dir where /tmp doesn't exist.
+ */
+export function resolveExportDir(
+	configured: string | null,
+	home: string,
+	slashTmpExists: boolean,
+	fallbackTmp: string,
+): string {
+	if (configured !== null) {
+		if (configured === "~") return home;
+		if (configured.startsWith("~/")) return join(home, configured.slice(2));
+		return configured;
+	}
+	return slashTmpExists ? "/tmp" : fallbackTmp;
+}
+
 /** Quote a CSV field only when it needs it (comma, quote, or newline). */
 function csvField(value: string | number): string {
 	const s = String(value);

package/index.ts

@@ -13,7 +13,7 @@ import type { ExtensionAPI, ExtensionCommandContext, Theme } from "@earendil-wor
 import { DynamicBorder } from "@earendil-works/pi-coding-agent";
 import { CancellableLoader, Container, Spacer, matchesKey, visibleWidth, truncateToWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 
-import { collectUsageData, TAB_ORDER } from "./data";
+import { collectUsageData, getAgentDir, TAB_ORDER } from "./data";
 import type { CollectProgress } from "./data";
 import type { BaseStats, ProviderStats, TabName, TotalStats, UsageData } from "./data";
 import {
@@ -26,8 +26,16 @@ import {
 	TOTAL_SERIES_KEY,
 } from "./graph";
 import type { GraphGroupBy, GraphMetric, GraphModel } from "./graph";
-import { buildGraphCsv, buildInsightsJson, buildTableCsv, exportFileName } from "./export";
-import { writeFileSync } from "node:fs";
+import {
+	buildGraphCsv,
+	buildInsightsJson,
+	buildTableCsv,
+	exportFileName,
+	parseExportDirSetting,
+	resolveExportDir,
+} from "./export";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
 import { join } from "node:path";
 
 type ViewMode = "table" | "insights" | "graph";
@@ -524,9 +532,19 @@ class UsageComponent {
 			content = buildTableCsv(visible.providers, visible.totals);
 		}
 		try {
-			const path = join(process.cwd(), name);
+			let configured: string | null = null;
+			try {
+				configured = parseExportDirSetting(readFileSync(join(getAgentDir(), "settings.json"), "utf8"));
+			} catch {
+				// No settings file or unreadable: fall through to the default dir.
+			}
+			const home = homedir();
+			const dir = resolveExportDir(configured, home, existsSync("/tmp"), tmpdir());
+			mkdirSync(dir, { recursive: true });
+			const path = join(dir, name);
 			writeFileSync(path, content);
-			this.exportNote = { text: `Saved ${name}`, ok: true };
+			const shown = path.startsWith(home + "/") ? "~" + path.slice(home.length) : path;
+			this.exportNote = { text: `Saved ${shown}`, ok: true };
 		} catch (err) {
 			this.exportNote = { text: `Export failed: ${err instanceof Error ? err.message : String(err)}`, ok: false };
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-usage-extension",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Usage statistics dashboard for Pi sessions.",
   "license": "MIT",
   "author": "Thomas Mustier",