@xynogen/pix-commands 0.1.0

package/package.json

@@ -0,0 +1,43 @@
+{
+	"name": "@xynogen/pix-commands",
+	"version": "0.1.0",
+	"description": "Pi extension — /diff and /clear commands",
+	"type": "module",
+	"main": "src/index.ts",
+	"scripts": {
+		"test": "bun test"
+	},
+	"files": [
+		"src",
+		"README.md",
+		"LICENSE"
+	],
+	"pi": {
+		"extensions": [
+			"src/extension.ts"
+		]
+	},
+	"keywords": [
+		"pi",
+		"pi-package",
+		"pi-extension",
+		"pix"
+	],
+	"author": "xynogen",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/xynogen/pix-mono.git",
+		"directory": "packages/pix-commands"
+	},
+	"homepage": "https://github.com/xynogen/pix-mono/tree/main/packages/pix-commands#readme",
+	"bugs": {
+		"url": "https://github.com/xynogen/pix-mono/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*"
+	}
+}

package/src/clear.ts

@@ -0,0 +1,32 @@
+import type {
+	ExtensionAPI,
+	ExtensionCommandContext,
+} from "@earendil-works/pi-coding-agent";
+
+async function clearCache(pi: ExtensionAPI, ctx: ExtensionCommandContext) {
+	ctx.ui.notify("Clearing ~/.cache/pi", "info");
+	const result = await pi.exec("/bin/sh", ["-lc", 'rm -rf "$HOME/.cache/pi"'], {
+		timeout: 10_000,
+	});
+	const output = [result.stdout, result.stderr]
+		.filter(Boolean)
+		.join("\n")
+		.trim();
+	if ((result.code ?? 0) !== 0) {
+		ctx.ui.notify(`Cache clear failed. ${output || "No output."}`, "error");
+		return;
+	}
+	ctx.ui.notify(
+		"~/.cache/pi cleared. Run /reload to apply changes.",
+		"warning",
+	);
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("clear", {
+		description: "Remove ~/.cache/pi and reload",
+		handler: async (_args, ctx) => {
+			await clearCache(pi, ctx);
+		},
+	});
+}

package/src/diff.ts

@@ -0,0 +1,38 @@
+/**
+ * /diff — summarise unstaged git diff: what changed, why, and impact.
+ *
+ * The agent runs `git status` + `git diff`, then replies with:
+ *   1. One-line TL;DR of the overall change
+ *   2. Per-file summary: what changed and why (not just counts)
+ *   3. Brief impact note (behaviour change, bug fix, refactor, etc.)
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+const DIFF_PROMPT = `Run \`git status\` and \`git diff\` to inspect all unstaged changes, then respond with:
+
+**TL;DR** — one sentence: what is the overall change.
+
+**Per-file breakdown** — for each changed file:
+- Filename (+lines/-lines)
+- What changed (describe the actual code change)
+- Why it changed (intent / reason behind the edit)
+
+**Impact** — one sentence: what effect does this have on behaviour, tests, or users.
+
+Rules: base everything on the actual diff content. Use \`git diff --stat\` for line counts. Skip staged-only changes. Be concise — each file entry should fit in 1-2 lines.`;
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("diff", {
+		description:
+			"Summarise unstaged diff: TL;DR, per-file what/why/counts, impact",
+		handler: async (_args, ctx) => {
+			if (!ctx.isIdle()) {
+				pi.sendUserMessage(DIFF_PROMPT, { deliverAs: "followUp" });
+				ctx.ui.notify("Queued /diff after the current turn finishes.", "info");
+				return;
+			}
+			pi.sendUserMessage(DIFF_PROMPT);
+		},
+	});
+}

package/src/extension.ts

@@ -0,0 +1,8 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import registerClear from "./clear.ts";
+import registerDiff from "./diff.ts";
+
+export default function (pi: ExtensionAPI): void {
+	registerDiff(pi);
+	registerClear(pi);
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { default as registerClear } from "./clear.ts";
+export { default as registerDiff } from "./diff.ts";