pi-rtk-optimizer 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.4] - 2026-04-22
+
+### Fixed
+- Respected `PI_CODING_AGENT_DIR` when resolving the global extension config directory and preserved exact skill reads under the configured global Pi skills path.
+
+### Changed
+- Updated README installation/configuration guidance and the settings modal description to document configurable global Pi paths.
+- Removed session-switch lifecycle reinitialization from the extension runtime.
+- Updated `@mariozechner/pi-coding-agent` and `@mariozechner/pi-tui` peer dependencies to ^0.68.1.
+
+## [0.5.3] - 2026-04-01
+
+### Changed
+- Updated README.md with new background image source URL
+- Aligned npm keywords for better package discoverability
+- Added Related Pi Extensions cross-linking section to README
+
 ## [0.5.2] - 2026-04-01
 
 ### Changed

package/README.md

@@ -2,7 +2,8 @@
 
 > RTK command rewriting and tool output compaction extension for the Pi coding agent.
 
-![background](https://raw.githubusercontent.com/MasuRii/pi-rtk-optimizer/main/asset/pi-rtk-optimizer-background.png)
+<img width="1360" height="752" alt="image" src="https://github.com/user-attachments/assets/f4536889-62ec-429a-984e-dc0de9f1f709" />
+
 
 **pi-rtk-optimizer** automatically rewrites `bash` tool commands to their `rtk` equivalents and compacts noisy tool output (`bash`, `read`, `grep`) to reduce context window usage while preserving actionable information for the AI agent.
 
@@ -58,8 +59,8 @@ Multi-stage pipeline to reduce token consumption:
 
 Place this folder in one of the following locations:
 
-```
-~/.pi/agent/extensions/pi-rtk-optimizer     # Global (all projects)
+```text
+~/.pi/agent/extensions/pi-rtk-optimizer     # Global default (when PI_CODING_AGENT_DIR is unset)
 .pi/extensions/pi-rtk-optimizer              # Project-specific
 ```
 
@@ -106,8 +107,9 @@ Use arrow keys to navigate settings, Enter to cycle values, and Escape to close.
 
 Configuration is stored at:
 
-```
-~/.pi/agent/extensions/pi-rtk-optimizer/config.json
+```text
+Default global path: ~/.pi/agent/extensions/pi-rtk-optimizer/config.json
+Actual global path: $PI_CODING_AGENT_DIR/extensions/pi-rtk-optimizer/config.json when PI_CODING_AGENT_DIR is set
 ```
 
 A starter template is included at `config/config.example.json`.
@@ -287,6 +289,13 @@ Inspired by:
 - [mcowger/pi-rtk](https://github.com/mcowger/pi-rtk)
 - [rtk-ai/rtk](https://github.com/rtk-ai/rtk)
 
+## Related Pi Extensions
+
+- [pi-tool-display](https://github.com/MasuRii/pi-tool-display) — Compact tool rendering and diff visualization
+- [pi-permission-system](https://github.com/MasuRii/pi-permission-system) — Permission enforcement for tool and command access
+- [pi-smart-voice-notify](https://github.com/MasuRii/pi-smart-voice-notify) — Multi-channel TTS and sound notifications
+- [pi-image-tools](https://github.com/MasuRii/pi-image-tools) — Image attachment and inline preview
+
 ## License
 
 [MIT](LICENSE) © MasuRii

package/package.json

@@ -1,60 +1,64 @@
-{
-  "name": "pi-rtk-optimizer",
-  "version": "0.5.2",
-  "description": "Pi extension that optimizes RTK command rewriting and tool output compaction for the coding agent.",
-  "type": "module",
-  "main": "./index.ts",
-  "exports": {
-    ".": "./index.ts"
-  },
-  "files": [
-    "index.ts",
-    "src",
-    "config/config.example.json",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "npx --yes -p typescript@5.7.3 tsc -p tsconfig.json --noCheck",
-    "lint": "npm run build",
-    "typecheck": "npx --yes -p typescript@5.7.3 tsc -p tsconfig.json",
-    "test": "bun ./src/output-compactor-test.ts && bun ./src/command-rewriter-test.ts && bun ./src/runtime-guard-test.ts && bun ./src/additional-coverage-test.ts && bun ./src/config-modal-test.ts && bun ./src/index-test.ts",
-    "check": "npm run lint && npm run typecheck && npm run test",
-    "build:check": "bunx esbuild ./index.ts --bundle --platform=node --format=esm --outfile=./.pi-rtk-optimizer-check.mjs --external:@mariozechner/pi-coding-agent --external:@mariozechner/pi-tui && bun -e \"import { unlinkSync } from 'node:fs'; unlinkSync('./.pi-rtk-optimizer-check.mjs');\""
-  },
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "rtk",
-    "token-optimization",
-    "tool-compaction",
-    "coding-agent"
-  ],
-  "author": "MasuRii",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MasuRii/pi-rtk-optimizer.git"
-  },
-  "bugs": {
-    "url": "https://github.com/MasuRii/pi-rtk-optimizer/issues"
-  },
-  "homepage": "https://github.com/MasuRii/pi-rtk-optimizer#readme",
-  "engines": {
-    "node": ">=20"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "^0.64.0",
-    "@mariozechner/pi-tui": "^0.64.0"
-  }
-}
+{
+  "name": "pi-rtk-optimizer",
+  "version": "0.5.4",
+  "description": "Pi extension that optimizes RTK command rewriting and tool output compaction for the coding agent.",
+  "type": "module",
+  "main": "./index.ts",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "config/config.example.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npx --yes -p typescript@5.7.3 tsc -p tsconfig.json --noCheck",
+    "lint": "npm run build",
+    "typecheck": "npx --yes -p typescript@5.7.3 tsc -p tsconfig.json",
+    "test": "bun ./src/output-compactor-test.ts && bun ./src/command-rewriter-test.ts && bun ./src/runtime-guard-test.ts && bun ./src/additional-coverage-test.ts && bun ./src/config-modal-test.ts && bun ./src/index-test.ts",
+    "check": "npm run lint && npm run typecheck && npm run test",
+    "build:check": "bunx esbuild ./index.ts --bundle --platform=node --format=esm --outfile=./.pi-rtk-optimizer-check.mjs --external:@mariozechner/pi-coding-agent --external:@mariozechner/pi-tui && bun -e \"import { unlinkSync } from 'node:fs'; unlinkSync('./.pi-rtk-optimizer-check.mjs');\""
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "pi-coding-agent",
+    "coding-agent",
+    "rtk",
+    "token-optimization",
+    "tool-compaction",
+    "output-compaction",
+    "command-rewrite",
+    "optimization"
+  ],
+  "author": "MasuRii",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MasuRii/pi-rtk-optimizer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MasuRii/pi-rtk-optimizer/issues"
+  },
+  "homepage": "https://github.com/MasuRii/pi-rtk-optimizer#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "^0.68.1",
+    "@mariozechner/pi-tui": "^0.68.1"
+  }
+}

package/src/additional-coverage-test.ts

@@ -1,13 +1,20 @@
 import assert from "node:assert/strict";
+import { mock } from "bun:test";
 import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 
-import {
+const MOCK_AGENT_DIR = "C:/tmp/.pi/agent";
+
+mock.module("@mariozechner/pi-coding-agent", () => ({
+	getAgentDir: () => MOCK_AGENT_DIR,
+}));
+
+const {
 	ensureConfigExists,
 	getRtkIntegrationConfigPath,
 	loadRtkIntegrationConfig,
 	normalizeRtkIntegrationConfig,
 	saveRtkIntegrationConfig,
-} from "./config-store.ts";
+} = await import("./config-store.ts");
 import { clearOutputMetrics, getOutputMetricsSummary, trackOutputSavings } from "./output-metrics.ts";
 import { runTest } from "./test-helpers.ts";
 import { matchesCommandPatterns, normalizeCommandForDetection } from "./techniques/command-detection.ts";

package/src/config-modal.ts

@@ -143,7 +143,7 @@ function buildSettingItems(config: RtkIntegrationConfig): SettingItem[] {
 		{
 			id: "outputPreserveExactSkillReads",
 			label: "Preserve exact skill reads",
-			description: "If on, read results under ~/.pi/agent/skills, ~/.agents/skills, .pi/skills, and ancestor .agents/skills skip read compaction",
+			description: "If on, read results under the global Pi skills directory (default: ~/.pi/agent/skills, respects PI_CODING_AGENT_DIR), ~/.agents/skills, .pi/skills, and ancestor .agents/skills skip read compaction",
 			currentValue: toOnOff(config.outputCompaction.preserveExactSkillReads),
 			values: ON_OFF,
 		},

package/src/constants.ts

@@ -1,6 +1,6 @@
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-export const EXTENSION_NAME = "pi-rtk-optimizer";
-export const CONFIG_DIR = join(homedir(), ".pi", "agent", "extensions", EXTENSION_NAME);
-export const CONFIG_PATH = join(CONFIG_DIR, "config.json");
+import { getAgentDir } from "@mariozechner/pi-coding-agent";
+import { join } from "node:path";
+
+export const EXTENSION_NAME = "pi-rtk-optimizer";
+export const CONFIG_DIR = join(getAgentDir(), "extensions", EXTENSION_NAME);
+export const CONFIG_PATH = join(CONFIG_DIR, "config.json");

package/src/index-test.ts

@@ -4,6 +4,7 @@ import { mock } from "bun:test";
 import { runTest } from "./test-helpers.ts";
 
 mock.module("@mariozechner/pi-coding-agent", () => ({
+	getAgentDir: () => "/tmp/.pi/agent",
 	getSettingsListTheme: () => ({}),
 	isToolCallEventType: (toolName: string, event: Record<string, unknown>) => event.toolName === toolName,
 }));

package/src/index.ts

@@ -262,14 +262,6 @@ export default function rtkIntegrationExtension(pi: ExtensionAPI): void {
 		maybeWarnRtkMissing(ctx);
 	});
 
-	pi.on("session_switch", async (_event, ctx) => {
-		warnedMessages.reset();
-		suggestionNotices.reset();
-		clearTrackedBashCommands();
-		missingRtkWarningShown = false;
-		await refreshConfig(ctx);
-		maybeWarnRtkMissing(ctx);
-	});
 
 	pi.on("agent_end", async () => {
 		clearTrackedBashCommands();

package/src/output-compactor-test.ts

@@ -1,10 +1,17 @@
 import assert from "node:assert/strict";
-import { homedir } from "node:os";
+import { mock } from "bun:test";
 import { join } from "node:path";
 
-import { compactToolResult } from "./output-compactor.ts";
 import { cloneDefaultConfig, runTest } from "./test-helpers.ts";
 
+const MOCK_AGENT_DIR = "C:/tmp/.pi/agent";
+
+mock.module("@mariozechner/pi-coding-agent", () => ({
+	getAgentDir: () => MOCK_AGENT_DIR,
+}));
+
+const { compactToolResult } = await import("./output-compactor.ts");
+
 function buildReadContent(lineCount: number): string {
 	const lines: string[] = [];
 	for (let index = 0; index < lineCount; index += 1) {
@@ -216,7 +223,7 @@ runTest("skill reads stay exact when preserveExactSkillReads is enabled for user
 	const result = compactToolResult(
 		{
 			toolName: "read",
-			input: { path: join(homedir(), ".pi", "agent", "skills", "example", "SKILL.md") },
+			input: { path: join(MOCK_AGENT_DIR, "skills", "example", "SKILL.md") },
 			content: [{ type: "text", text: content }],
 		},
 		config,

package/src/output-compactor.ts

@@ -1,3 +1,4 @@
+import { getAgentDir } from "@mariozechner/pi-coding-agent";
 import { homedir } from "node:os";
 import { dirname, join, resolve, sep } from "node:path";
 import {
@@ -60,7 +61,7 @@ const LOSSY_TECHNIQUE_PREFIXES = [
 
 const READ_EXACT_OUTPUT_LINE_THRESHOLD = 80;
 const READ_COMPACTION_BANNER_PREFIX = "[RTK compacted output:";
-const USER_SKILL_ROOTS = [join(homedir(), ".pi", "agent", "skills"), join(homedir(), ".agents", "skills")];
+const USER_SKILL_ROOTS = [join(getAgentDir(), "skills"), join(homedir(), ".agents", "skills")];
 
 function normalizePathForComparison(path: string): string {
 	return process.platform === "win32" ? path.toLowerCase() : path;

package/src/types-shims.d.ts

@@ -89,6 +89,7 @@ declare module "@mariozechner/pi-coding-agent" {
 		getFgAnsi?(name: string): string;
 	}
 
+	export function getAgentDir(): string;
 	export function getSettingsListTheme(): unknown;
 
 	export interface ExtensionAPI {