@liushihao456/pi-emacs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 liushihao
+
+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,43 @@
+# pi-emacs
+
+Pi extension for opening `emacsclient` from Pi's TUI.
+
+## Features
+
+- Starts an Emacs daemon automatically when Pi starts.
+- Adds `/emacs` command.
+- Adds `ctrl+g` shortcut to open `emacsclient -nw` in the terminal.
+- Remembers the last file touched by Pi `edit` / `write` tools and opens it on next launch.
+- Falls back to `dired` in the current working directory when no recent file exists.
+- Enables terminal mouse support inside Emacs.
+- Stops the daemon on Pi quit only if this extension started it.
+
+## Install
+
+```bash
+pi install npm:@liushihao456/pi-emacs
+```
+
+For local development:
+
+```bash
+pi install /path/to/pi-emacs
+# or copy this directory to ~/.pi/agent/extensions/pi-emacs
+```
+
+## Requirements
+
+- Emacs available as `emacs`
+- Emacs client available as `emacsclient`
+- Pi interactive TUI mode
+
+## Usage
+
+- `/emacs` — open Emacs client
+- `ctrl+g` — open Emacs client
+
+## Publish
+
+```bash
+npm publish --access public
+```

package/index.ts

@@ -0,0 +1,192 @@
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { spawn } from "node:child_process";
+import { isAbsolute, resolve } from "node:path";
+
+type EmacsState = {
+	startedEmacsServer: boolean;
+	serverStartPromise?: Promise<void>;
+	lastEditedFile?: string;
+};
+
+const state: EmacsState = ((globalThis as any).__piEmacsExtensionState ??= {
+	startedEmacsServer: false,
+});
+
+type SpawnOptions = {
+	cwd?: string;
+	stdio?: "inherit" | "ignore";
+	timeoutMs?: number;
+	onBefore?: () => void;
+	onAfter?: () => void;
+};
+
+function run(command: string, args: string[], options: SpawnOptions = {}) {
+	return new Promise<void>((resolve, reject) => {
+		options.onBefore?.();
+
+		const child = spawn(command, args, {
+			cwd: options.cwd,
+			env: process.env,
+			stdio: options.stdio ?? "ignore",
+		});
+
+		const timer = options.timeoutMs
+			? setTimeout(() => {
+					child.kill("SIGTERM");
+					finish(new Error(`${command} timed out`));
+				}, options.timeoutMs)
+			: undefined;
+
+		let done = false;
+		const finish = (error?: Error) => {
+			if (done) return;
+			done = true;
+			if (timer) clearTimeout(timer);
+			options.onAfter?.();
+			error ? reject(error) : resolve();
+		};
+
+		child.on("error", finish);
+		child.on("close", (code, signal) => {
+			code === 0
+				? finish()
+				: finish(new Error(`${command} exited with ${signal ?? code}`));
+		});
+	});
+}
+
+function emacsClient(args: string[], options: SpawnOptions = {}) {
+	return run("emacsclient", args, options);
+}
+
+function withTerminalMouse(expression: string) {
+	return `(progn (xterm-mouse-mode 1) (mouse-wheel-mode 1) ${expression})`;
+}
+
+function findFileExpression(path: string) {
+	return withTerminalMouse(
+		[
+			`(let* ((file ${JSON.stringify(path)})`,
+			"(buf (find-buffer-visiting file)))",
+			"(if buf",
+			"(progn",
+			"(with-current-buffer buf",
+			"(when (and (not (buffer-modified-p))",
+			"(not (verify-visited-file-modtime buf)))",
+			"(revert-buffer :ignore-auto :noconfirm)))",
+			"(switch-to-buffer buf))",
+			"(find-file file)))",
+		].join(" "),
+	);
+}
+
+function diredExpression(cwd: string) {
+	return withTerminalMouse(`(dired ${JSON.stringify(cwd)})`);
+}
+
+function emacsClientArgs(cwd: string) {
+	return state.lastEditedFile
+		? ["-nw", "-a", "", "-e", findFileExpression(state.lastEditedFile)]
+		: ["-nw", "-a", "", "-e", diredExpression(cwd)];
+}
+
+function rememberEditedFile(input: unknown, cwd: string) {
+	const path = (input as { path?: string }).path;
+	if (!path) return;
+	state.lastEditedFile = isAbsolute(path) ? path : resolve(cwd, path);
+}
+
+async function ensureEmacsServer() {
+	state.serverStartPromise ??= (async () => {
+		try {
+			await emacsClient(["--eval", "(emacs-pid)"], { timeoutMs: 2000 });
+			return;
+		} catch {
+			// No reachable server. Start daemon below.
+		}
+
+		console.log("[emacs] starting daemon...");
+		await run("emacs", ["--daemon"], { timeoutMs: 15000 });
+		state.startedEmacsServer = true;
+		console.log("[emacs] daemon started");
+	})();
+
+	return state.serverStartPromise;
+}
+
+async function stopEmacsServer() {
+	if (!state.startedEmacsServer) return;
+
+	try {
+		await state.serverStartPromise;
+	} catch {
+		return;
+	}
+
+	await emacsClient(["--eval", "(kill-emacs)"], { timeoutMs: 5000 });
+	state.startedEmacsServer = false;
+	state.serverStartPromise = undefined;
+}
+
+async function openEmacsClient(ctx: ExtensionContext) {
+	if (!ctx.hasUI) {
+		ctx.ui.notify("emacsclient requires TUI mode", "error");
+		return;
+	}
+
+	await ctx.ui.custom((tui, _theme, _keybindings, done) => {
+		emacsClient(emacsClientArgs(ctx.cwd), {
+			cwd: ctx.cwd,
+			stdio: "inherit",
+			onBefore: () => {
+				tui.stop();
+				process.stdout.write("\x1B[2J\x1B[H");
+				process.stdout.write("\x1B[?1000l\x1B[?1002l\x1B[?1003l\x1B[?1006l");
+			},
+			onAfter: () => {
+				tui.start();
+				tui.requestRender(true);
+			},
+		})
+			.then(() => done(null))
+			.catch((error) => {
+				ctx.ui.notify(`Failed to start emacsclient: ${error.message}`, "error");
+				done(null);
+			});
+
+		return { render: () => [], invalidate: () => {} };
+	});
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.on("session_start", () => {
+		ensureEmacsServer().catch((error) => {
+			console.error(`[emacs] failed to start server: ${error.message}`);
+		});
+	});
+
+	pi.on("session_shutdown", async (event) => {
+		if (event.reason === "quit") await stopEmacsServer();
+	});
+
+	pi.on("tool_result", (event, ctx) => {
+		if (!event.isError && ["edit", "write"].includes(event.toolName)) {
+			rememberEditedFile(event.input, ctx.cwd);
+		}
+	});
+
+	pi.registerCommand("emacs", {
+		description: "Open emacsclient in popup terminal",
+		handler: async (_args, ctx) => openEmacsClient(ctx),
+	});
+
+	pi.registerShortcut("ctrl+g", {
+		description: "Open emacsclient",
+		handler: openEmacsClient,
+	});
+}
+
+export { ensureEmacsServer, openEmacsClient, stopEmacsServer };

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@liushihao456/pi-emacs",
+  "version": "0.1.0",
+  "description": "Pi extension that opens emacsclient in a popup terminal and tracks recently edited files.",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "emacs",
+    "emacsclient"
+  ],
+  "license": "MIT",
+  "author": "liushihao",
+  "files": [
+    "index.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "echo 'nothing to build'",
+    "check": "bun build ./index.ts --target=node --outfile=/tmp/pi-emacs-check.js --external @earendil-works/pi-coding-agent"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}