@averyyy/pi-client 0.80.3 → 0.80.6-piclient.5

package/CHANGELOG.md

@@ -5,5 +5,14 @@
 - Initial `pi-client` package as a lightweight wrapper that exposes only the `pi-client` bin without `pi`.
 - Global install wrapper that launches the local forked coding-agent entrypoint while sharing the original `~/.pi/agent` configuration.
 - `pi-client update` command for updating the fork checkout and reinstalling both `pi-client` and `pi-server`.
-- `pi-client web` command that starts the PI WEB client GUI on port `1838` by default.
-- Pi Server status, URL settings, client actions, project visibility, and global `AGENTS.md` editing inside `pi-client web`.
+- npm global package updates during `pi-client update`.
+- `pi-client web` command that starts the client backend in Tau mirror mode on port `1838` by default.
+
+### Fixed
+
+- Used `--legacy-peer-deps` for npm-global fork updates and documented installs so existing upstream Pi installs do not trigger peer override warnings for forked prerelease aliases.
+
+### Changed
+
+- Rebased the client on upstream Pi `0.80.6`, including GPT-5.6 model metadata and `max` thinking support.
+- Changed `pi-client update` to update global packages without reinstalling the active checkout or stopping sessions; updated sessions require `/reload` to restart on the new runtime with their existing history.

package/README.md

@@ -0,0 +1,54 @@
+# @averyyy/pi-client
+
+Client CLI for connecting Pi to a `pi-server` instance.
+
+## Install
+
+```bash
+npm i -g --ignore-scripts --legacy-peer-deps @averyyy/pi-client
+```
+
+`--legacy-peer-deps` avoids npm peer override warnings when upstream Pi is already installed globally.
+
+## Use
+
+Connect to the hosted server:
+
+```bash
+PI_SERVER_URL=https://pi.yreva.asia pi-client
+```
+
+Send one prompt and exit:
+
+```bash
+PI_SERVER_URL=https://pi.yreva.asia pi-client -p "Say exactly: ok"
+```
+
+Start the browser UI:
+
+```bash
+pi install npm:tau-mirror
+PI_SERVER_URL=https://pi.yreva.asia pi-client web
+```
+
+The web command starts `pi-client` in Tau mirror mode. Tau listens on `http://127.0.0.1:1838` by default and uses the same shared `~/.pi/agent` extension install as local `pi`, so installing Tau with either `pi` or `pi-client` works.
+
+## Server Auth
+
+If your server uses an auth token, set it on the client:
+
+```bash
+PI_SERVER_AUTH_TOKEN=your-token PI_SERVER_URL=http://127.0.0.1:4217 pi-client
+```
+
+## Update
+
+`pi-client update` installs the latest client and server packages without stopping active client sessions. Existing sessions block new prompts until you run `/reload`; `/reload` restarts that session on the new runtime and resumes its persisted history.
+
+## Related Package
+
+Install the server separately:
+
+```bash
+npm i -g --ignore-scripts @averyyy/pi-server
+```

package/bin/pi-client.js

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
+import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const args = process.argv.slice(2);
 const modulePromise =
 	args[0] === "update"
-		? import("./update.js").then(({ runPiClientUpdate }) => {
-				process.exitCode = runPiClientUpdate(args.slice(1));
+		? import("./update.js").then(async ({ runPiClientUpdate }) => {
+				process.exitCode = await runPiClientUpdate(args.slice(1));
 			})
 		: args[0] === "web"
 			? import("./web.js").then(async ({ runPiClientWeb }) => {
@@ -21,15 +23,66 @@ Promise.resolve(modulePromise).catch((e) => {
 });
 
 function runPiClientCli(args) {
+	const reloadDir = mkdtempSync(join(tmpdir(), "pi-client-reload-"));
+	const reloadStatePath = join(reloadDir, "state.json");
+	let cliPath = getLocalCliPath();
+	let childArgs = args;
+
+	try {
+		for (;;) {
+			const result = spawnSync(process.execPath, [cliPath, ...childArgs], {
+				env: {
+					...process.env,
+					PI_CODING_AGENT: "true",
+					PI_SERVER_MODE: "true",
+					PI_CLIENT_RELOAD_STATE_PATH: reloadStatePath,
+				},
+				stdio: "inherit",
+			});
+			if (result.error) throw result.error;
+			if (result.status !== 75) {
+				process.exitCode = result.status ?? (result.signal === "SIGINT" ? 130 : 1);
+				return;
+			}
+
+			const state = readReloadState(reloadStatePath);
+			if (!state) {
+				console.error("pi-client reload failed: missing session state from the previous runtime.");
+				process.exitCode = 1;
+				return;
+			}
+			rmSync(state.updateMarkerPath, { force: true });
+			childArgs = state.sessionDir ? ["--session-dir", state.sessionDir, "--session", state.sessionId] : ["--session", state.sessionId];
+			cliPath = getUpdatedGlobalCliPath() ?? getLocalCliPath();
+		}
+	} finally {
+		rmSync(reloadDir, { recursive: true, force: true });
+	}
+}
+
+function getLocalCliPath() {
 	const entry = fileURLToPath(import.meta.resolve("@earendil-works/pi-coding-agent"));
-	const result = spawnSync(process.execPath, [join(dirname(entry), "cli.js"), ...args], {
-		env: {
-			...process.env,
-			PI_CODING_AGENT: "true",
-			PI_SERVER_MODE: "true",
-		},
-		stdio: "inherit",
-	});
-	if (result.error) throw result.error;
-	process.exitCode = result.status ?? (result.signal === "SIGINT" ? 130 : 1);
+	return join(dirname(entry), "cli.js");
+}
+
+function getUpdatedGlobalCliPath() {
+	const npmCli = join(dirname(process.execPath), "node_modules", "npm", "bin", "npm-cli.js");
+	const result = existsSync(npmCli)
+		? spawnSync(process.execPath, [npmCli, "root", "-g"], { encoding: "utf-8" })
+		: spawnSync("npm", ["root", "-g"], { encoding: "utf-8" });
+	if (result.status !== 0) return undefined;
+	const root = result.stdout.trim();
+	const cliPath = join(root, "@averyyy", "pi-client", "node_modules", "@earendil-works", "pi-coding-agent", "dist", "cli.js");
+	return existsSync(cliPath) ? cliPath : undefined;
+}
+
+function readReloadState(path) {
+	try {
+		const value = JSON.parse(readFileSync(path, "utf-8"));
+		if (typeof value.sessionId !== "string" || typeof value.updateMarkerPath !== "string") return undefined;
+		if (value.sessionDir !== undefined && typeof value.sessionDir !== "string") return undefined;
+		return value;
+	} catch {
+		return undefined;
+	}
 }

package/bin/update.js

@@ -1,16 +1,13 @@
 import { spawnSync } from "node:child_process";
-import { readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 function defaultPackageRoot() {
 	return dirname(dirname(fileURLToPath(import.meta.url)));
 }
 
-function defaultRepoRoot() {
-	return resolve(defaultPackageRoot(), "..", "..");
-}
-
 function readPackageMetadata(packageRoot) {
 	return JSON.parse(readFileSync(resolve(packageRoot, "package.json"), "utf-8"));
 }
@@ -19,44 +16,53 @@ function runStep(runner, command, args, cwd, stdio = "inherit") {
 	return runner(command, args, { cwd, stdio, encoding: "utf-8" });
 }
 
-export function runPiClientUpdate(_args = [], options = {}) {
+function defaultUpdateMarkerPath() {
+	return join(process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent"), "pi-client-update.json");
+}
+
+function writeUpdateMarker(path) {
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, `${JSON.stringify({ version: "latest", updatedAt: new Date().toISOString() })}\n`);
+}
+
+function runNpmGlobalUpdate(runner, cwd, stdout, stderr, updateMarkerPath) {
+	stdout.write("Updating npm packages: @averyyy/pi-client@latest @averyyy/pi-server@latest\n");
+	const result = runStep(
+		runner,
+		"npm",
+		[
+			"install",
+			"-g",
+			"--ignore-scripts",
+			"--legacy-peer-deps",
+			"--force",
+			"@averyyy/pi-client@latest",
+			"@averyyy/pi-server@latest",
+		],
+		cwd,
+	);
+	if (result.status !== 0) {
+		stderr.write(
+			"pi-client update failed: npm install -g --ignore-scripts --legacy-peer-deps --force @averyyy/pi-client@latest @averyyy/pi-server@latest\n",
+		);
+		return result.status ?? 1;
+	}
+	writeUpdateMarker(updateMarkerPath);
+	stdout.write("Updated package files without stopping active pi-client sessions. Run /reload in each session to switch runtimes.\n");
+	stdout.write("pi-client update complete\n");
+	return 0;
+}
+
+export async function runPiClientUpdate(_args = [], options = {}) {
 	const packageRoot = options.packageRoot ?? defaultPackageRoot();
-	const repoRoot = options.repoRoot ?? defaultRepoRoot();
 	const runner = options.runner ?? spawnSync;
 	const stdout = options.stdout ?? process.stdout;
 	const stderr = options.stderr ?? process.stderr;
+	const updateMarkerPath = options.updateMarkerPath ?? defaultUpdateMarkerPath();
 	const pkg = readPackageMetadata(packageRoot);
 	const baseVersion = pkg.piClient?.basePiVersion ?? "unknown";
 	const baseCommit = pkg.piClient?.basePiCommit ?? "unknown";
 
 	stdout.write(`pi-client ${pkg.version} (based on pi ${baseVersion}, upstream ${baseCommit})\n`);
-	stdout.write(`Updating checkout: ${repoRoot}\n`);
-
-	const status = runStep(runner, "git", ["status", "--porcelain"], repoRoot, "pipe");
-	if (status.status !== 0) {
-		stderr.write("pi-client update failed: unable to inspect git status\n");
-		return status.status ?? 1;
-	}
-	if (String(status.stdout ?? "").trim().length > 0) {
-		stderr.write("pi-client update failed: working tree has uncommitted changes\n");
-		return 1;
-	}
-
-	const steps = [
-		["git", ["pull", "--ff-only"]],
-		["npm", ["install", "--ignore-scripts"]],
-		["npm", ["run", "install:pi-client"]],
-		["npm", ["run", "install:pi-server"]],
-	];
-
-	for (const [command, args] of steps) {
-		const result = runStep(runner, command, args, repoRoot);
-		if (result.status !== 0) {
-			stderr.write(`pi-client update failed: ${command} ${args.join(" ")}\n`);
-			return result.status ?? 1;
-		}
-	}
-
-	stdout.write("pi-client update complete\n");
-	return 0;
+	return runNpmGlobalUpdate(runner, process.cwd(), stdout, stderr, updateMarkerPath);
 }

package/bin/web.js

@@ -1,23 +1,16 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { createRequire } from "node:module";
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
+import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
-import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { effectivePiWebConfig, maxUploadBytes, piWebDataDir } from "@jmfederico/pi-web/dist/config.js";
-import { buildApp } from "@jmfederico/pi-web/dist/server/app.js";
-import { PiWebPluginService } from "@jmfederico/pi-web/dist/server/piWebPluginService.js";
-import { ProjectService } from "@jmfederico/pi-web/dist/server/projects/projectService.js";
-import { ProjectStore } from "@jmfederico/pi-web/dist/server/storage/projectStore.js";
 
-const require = createRequire(import.meta.url);
-const piWebRoot = dirname(require.resolve("@jmfederico/pi-web/package.json"));
-const binDir = dirname(fileURLToPath(import.meta.url));
 const defaultPort = "1838";
 const defaultPiServerUrl = "http://127.0.0.1:4217";
+const tauCodexPackage = "@averyyy/pi-tau-codex";
+const tauCodexInstallTarget = "npm:@averyyy/pi-tau-codex";
+const tauCodexGitTarget = "git:github.com/Averyyy/pi-tau-codex";
 
 export async function runPiClientWeb(args = process.argv.slice(2)) {
 	const parsed = parseArgs(args);
@@ -26,256 +19,97 @@ export async function runPiClientWeb(args = process.argv.slice(2)) {
 		return 0;
 	}
 
+	if (!hasTauCodexExtensionInstalled(process.env)) {
+		if (!await offerTauCodexInstall()) return 1;
+	}
+
 	process.title = "pi-client web";
-	const piServer = await effectivePiServerSettings(process.env);
-	const childEnv = {
-		...process.env,
-		PI_CODING_AGENT: "true",
-		PI_SERVER_MODE: "true",
-		PI_SERVER_URL: piServer.serverUrl,
-		PI_WEB_HOST: process.env.PI_WEB_HOST ?? "127.0.0.1",
-		PI_WEB_PORT: parsed.port,
-	};
-	const sessiond = spawn(process.execPath, [join(piWebRoot, "dist", "server", "sessiond.js")], { env: childEnv, stdio: "inherit" });
-	const { config } = effectivePiWebConfig({ env: childEnv });
-	const projects = new PiClientProjectService(new ProjectService(new ProjectStore()), process.env);
-	const app = await buildApp({
-		bodyLimit: maxUploadBytes(childEnv, config),
-		projects,
-		piWebPlugins: new PiWebPluginService({
-			roots: [
-				{ path: join(piWebRoot, "dist", "pi-web-plugins"), source: "bundled", scope: "bundled" },
-				{ path: join(binDir, "pi-web-plugins"), source: "pi-client", scope: "bundled" },
-				{ path: join(piWebDataDir(childEnv), "plugins"), source: "local", scope: "local" },
-			],
-		}),
+	const entry = fileURLToPath(import.meta.resolve("@earendil-works/pi-coding-agent"));
+	const port = parsed.port;
+	const host = process.env.TAU_HOST ?? "127.0.0.1";
+	const child = spawn(process.execPath, [join(dirname(entry), "cli.js"), ...parsed.clientArgs], {
+		env: piClientWebEnv(process.env, { port, host }),
+		stdio: "inherit",
 	});
-	registerPiClientRoutes(app, { env: process.env, startupPiServerUrl: piServer.serverUrl, projects });
-	await app.listen({ port: config.port ?? Number.parseInt(defaultPort, 10), host: config.host ?? "127.0.0.1" });
-	console.log(`pi-client web listening on http://${config.host ?? "127.0.0.1"}:${config.port ?? defaultPort}`);
 
-	let shuttingDown = false;
-	return await new Promise((resolve) => {
-		const shutdown = (exitCode) => {
-			if (shuttingDown) return;
-			shuttingDown = true;
-			sessiond.kill();
-			void app.close().finally(() => {
-				resolve(exitCode);
-			});
-		};
+	console.log(`pi-client web uses Tau at http://${host}:${port}`);
 
-		sessiond.once("error", (error) => {
-			console.error(error);
-			shutdown(1);
-		});
-		sessiond.once("exit", (code, signal) => {
-			shutdown(code ?? (signal === "SIGINT" ? 130 : 1));
+	return await new Promise((resolve, reject) => {
+		child.once("error", reject);
+		child.once("exit", (code, signal) => {
+			resolve(code ?? (signal === "SIGINT" ? 130 : 1));
 		});
-		process.once("SIGINT", () => shutdown(130));
-		process.once("SIGTERM", () => shutdown(143));
 	});
 }
 
-function registerPiClientRoutes(app, state) {
-	app.get("/api/pi-client/pi-server", async (_request, _reply) => piServerStatus(state));
-	app.put("/api/pi-client/pi-server", async (request, reply) => {
-		const body = request.body;
-		if (body === null || typeof body !== "object" || Array.isArray(body)) {
-			return reply.code(400).send({ error: "pi-server settings update must be an object" });
-		}
-		const piServerUrl = validatePiServerUrl(body.piServerUrl);
-		await savePiClientWebConfig({ piServerUrl }, state.env);
-		return piServerStatus(state);
-	});
-	app.get("/api/pi-client/global-agents", async () => globalAgentsFile());
-	app.put("/api/pi-client/global-agents", async (request, reply) => {
-		const body = request.body;
-		if (body === null || typeof body !== "object" || Array.isArray(body)) {
-			return reply.code(400).send({ error: "global AGENTS.md update must be an object" });
-		}
-		const content = validateGlobalAgentsContent(body.content);
-		await saveGlobalAgentsFile(content);
-		return globalAgentsFile();
-	});
-	app.get("/api/pi-client/projects", async () => state.projects.listWithVisibility());
-	app.put("/api/pi-client/projects/:projectId/visibility", async (request, reply) => {
-		const body = request.body;
-		if (body === null || typeof body !== "object" || Array.isArray(body)) {
-			return reply.code(400).send({ error: "project visibility update must be an object" });
-		}
-		if (typeof body.visible !== "boolean") return reply.code(400).send({ error: "visible must be a boolean" });
-		await state.projects.setVisibility(request.params.projectId, body.visible);
-		return state.projects.listWithVisibility();
-	});
-}
-
-async function piServerStatus(state) {
-	const settings = await effectivePiServerSettings(state.env);
-	const publicSettings = { ...settings };
-	delete publicSettings.authToken;
-	return {
-		...publicSettings,
-		restartRequired: settings.serverUrl !== state.startupPiServerUrl,
-		...(await checkPiServer(settings)),
-	};
-}
-
-async function checkPiServer(settings) {
-	const headers =
-		settings.authToken === undefined || settings.authToken === ""
-			? {}
-			: { authorization: `Bearer ${settings.authToken}` };
-	const controller = new AbortController();
-	const timeout = setTimeout(() => controller.abort(), 2000);
-	try {
-		const health = await fetch(new URL("/health", settings.serverUrl), { headers, signal: controller.signal });
-		const sessions = await fetch(new URL("/api/sessions", settings.serverUrl), { headers, signal: controller.signal });
-		return {
-			reachable: health.ok,
-			authenticated: sessions.status !== 401 && sessions.status !== 403,
-			status: sessions.status,
-			checkedAt: new Date().toISOString(),
-		};
-	} catch (error) {
-		return {
-			reachable: false,
-			authenticated: false,
-			error: error instanceof Error ? error.message : String(error),
-			checkedAt: new Date().toISOString(),
-		};
-	} finally {
-		clearTimeout(timeout);
-	}
-}
+export async function offerTauCodexInstall(env = process.env, input = process.stdin, output = process.stdout) {
+	printInstallRequired();
+	if (!input.isTTY || !output.isTTY) return false;
 
-async function effectivePiServerSettings(env) {
-	const config = await loadPiClientWebConfig(env);
-	const envUrl = env.PI_SERVER_URL;
-	const configUrl = config.piServerUrl;
-	return {
-		serverUrl:
-			envUrl !== undefined && envUrl !== ""
-				? validatePiServerUrl(envUrl)
-				: configUrl !== undefined && configUrl !== ""
-					? validatePiServerUrl(configUrl)
-					: defaultPiServerUrl,
-		urlSource: envUrl !== undefined && envUrl !== "" ? "environment" : configUrl !== undefined ? "config" : "default",
-		tokenConfigured: env.PI_SERVER_AUTH_TOKEN !== undefined && env.PI_SERVER_AUTH_TOKEN !== "",
-		authToken: env.PI_SERVER_AUTH_TOKEN,
-		configPath: piClientWebConfigPath(env),
-	};
-}
-
-async function loadPiClientWebConfig(env) {
-	const configPath = piClientWebConfigPath(env);
-	if (!existsSync(configPath)) return {};
-	const parsed = JSON.parse(await readFile(configPath, "utf-8"));
-	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-		throw new Error(`pi-client web config must be a JSON object: ${configPath}`);
-	}
-	return parsed;
-}
-
-async function savePiClientWebConfig(update, env) {
-	const configPath = piClientWebConfigPath(env);
-	const existing = await loadPiClientWebConfig(env);
-	await mkdir(dirname(configPath), { recursive: true });
-	await writeFile(configPath, `${JSON.stringify({ ...existing, ...update }, null, 2)}\n`, "utf-8");
-}
-
-function piClientWebConfigPath(env) {
-	if (env.PI_CLIENT_WEB_CONFIG !== undefined && env.PI_CLIENT_WEB_CONFIG !== "") return env.PI_CLIENT_WEB_CONFIG;
-	const xdgConfigHome = env.XDG_CONFIG_HOME;
-	return join(xdgConfigHome !== undefined && xdgConfigHome !== "" ? xdgConfigHome : join(homedir(), ".config"), "pi-client", "web.json");
-}
+	const rl = createInterface({ input, output });
+	const answer = (await rl.question("现在安装吗? [y/N] ")).trim().toLowerCase();
+	rl.close();
+	if (answer !== "y" && answer !== "yes") return false;
 
-function validatePiServerUrl(value) {
-	if (typeof value !== "string" || value.trim() === "") throw new Error("piServerUrl must be a non-empty string");
-	const url = new URL(value.trim());
-	if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error("piServerUrl must be http or https");
-	return url.toString().replace(/\/$/u, "");
+	const result = spawnSync(process.execPath, [join(dirname(fileURLToPath(import.meta.url)), "pi-client.js"), "install", tauCodexInstallTarget], {
+		env,
+		stdio: "inherit",
+	});
+	if (result.error) throw result.error;
+	return result.status === 0 && hasTauCodexExtensionInstalled(env);
 }
 
-async function globalAgentsFile() {
-	const filePath = globalAgentsPath();
-	const exists = existsSync(filePath);
+export function piClientWebEnv(env = process.env, options) {
 	return {
-		path: filePath,
-		exists,
-		content: exists ? await readFile(filePath, "utf-8") : "",
+		...env,
+		PI_CODING_AGENT: "true",
+		PI_SERVER_MODE: "true",
+		PI_SERVER_URL: env.PI_SERVER_URL ?? defaultPiServerUrl,
+		TAU_HOST: options.host,
+		TAU_MIRROR_PORT: options.port,
 	};
 }
 
-async function saveGlobalAgentsFile(content) {
-	const filePath = globalAgentsPath();
-	await mkdir(dirname(filePath), { recursive: true });
-	await writeFile(filePath, content, "utf-8");
+export function hasTauCodexExtensionInstalled(env = process.env) {
+	if (env.TAU_STATIC_DIR) return true;
+	const settingsPath = env.PI_CODING_AGENT_SETTINGS_PATH ?? join(
+		env.PI_CODING_AGENT_DIR ?? join(env.HOME ?? homedir(), ".pi", "agent"),
+		"settings.json",
+	);
+	if (!existsSync(settingsPath)) return false;
+	const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+	const packages = Array.isArray(settings.packages) ? settings.packages : [];
+	return packages.some(packageSpecMatchesTauCodex);
 }
 
-function globalAgentsPath() {
-	return join(getAgentDir(), "AGENTS.md");
+function packageSpecMatchesTauCodex(spec) {
+	if (typeof spec === "string") return specMatchesTauCodex(spec);
+	if (!spec || typeof spec !== "object") return false;
+	return ["source", "package", "name", "spec"].some((key) => specMatchesTauCodex(spec[key]));
 }
 
-function validateGlobalAgentsContent(value) {
-	if (typeof value !== "string") throw new Error("content must be a string");
-	return value;
-}
-
-class PiClientProjectService {
-	constructor(projects, env) {
-		this.projects = projects;
-		this.env = env;
-	}
-
-	async list() {
-		const [projects, hiddenProjectIds] = await Promise.all([this.projects.list(), loadHiddenProjectIds(this.env)]);
-		return projects.filter((project) => !hiddenProjectIds.has(project.id));
-	}
-
-	add(input) {
-		return this.projects.add(input);
-	}
-
-	close(id) {
-		return this.projects.close(id);
-	}
-
-	requireProject(id) {
-		return this.projects.requireProject(id);
-	}
-
-	async listWithVisibility() {
-		const [projects, hiddenProjectIds] = await Promise.all([this.projects.list(), loadHiddenProjectIds(this.env)]);
-		return projects.map((project) => ({ ...project, hidden: hiddenProjectIds.has(project.id) }));
-	}
-
-	async setVisibility(projectId, visible) {
-		await this.projects.requireProject(projectId);
-		const hiddenProjectIds = await loadHiddenProjectIds(this.env);
-		if (visible) {
-			hiddenProjectIds.delete(projectId);
-		} else {
-			hiddenProjectIds.add(projectId);
-		}
-		await savePiClientWebConfig({ hiddenProjectIds: [...hiddenProjectIds].sort() }, this.env);
-	}
-}
-
-async function loadHiddenProjectIds(env) {
-	const config = await loadPiClientWebConfig(env);
-	if (config.hiddenProjectIds === undefined) return new Set();
-	if (!Array.isArray(config.hiddenProjectIds) || !config.hiddenProjectIds.every((id) => typeof id === "string")) {
-		throw new Error("hiddenProjectIds must be an array of strings");
-	}
-	return new Set(config.hiddenProjectIds);
+function specMatchesTauCodex(spec) {
+	return typeof spec === "string" && (
+		spec === tauCodexPackage ||
+		spec === tauCodexInstallTarget ||
+		spec.startsWith(`${tauCodexPackage}@`) ||
+		spec.startsWith(`${tauCodexInstallTarget}@`) ||
+		spec === tauCodexGitTarget ||
+		spec.includes("github.com/Averyyy/pi-tau-codex")
+	);
 }
 
 function parseArgs(args) {
-	let port = process.env.PI_WEB_PORT ?? defaultPort;
+	let port = process.env.TAU_MIRROR_PORT ?? defaultPort;
+	const clientArgs = [];
+
 	for (let i = 0; i < args.length; i += 1) {
 		const arg = args[i];
-		if (arg === "--help" || arg === "-h") return { help: true, port };
+		if (arg === "--help" || arg === "-h") return { help: true, port, clientArgs };
+		if (arg === "--") {
+			clientArgs.push(...args.slice(i + 1));
+			break;
+		}
 		if (arg === "--port" || arg === "-p") {
 			port = requireValue(args, (i += 1), arg);
 			continue;
@@ -286,8 +120,9 @@ function parseArgs(args) {
 		}
 		throw new Error(`Unknown pi-client web argument: ${arg}`);
 	}
+
 	validatePort(port);
-	return { help: false, port };
+	return { help: false, port, clientArgs };
 }
 
 function requireValue(args, index, name) {
@@ -304,17 +139,30 @@ function validatePort(port) {
 }
 
 function printHelp() {
-	console.log(`Usage: pi-client web [--port <port>]
+	console.log(`Usage: pi-client web [--port <port>] [-- <pi-client args...>]
 
-Start the pi-client web UI.
+Start pi-client in Tau mirror mode.
 
 Options:
-  -p, --port <port>  Port to listen on (default: ${defaultPort})
+  -p, --port <port>  Tau port to listen on (default: ${defaultPort})
   -h, --help         Show this help
 
 Environment:
-  PI_SERVER_URL          pi-server URL used by browser sessions
+  PI_SERVER_URL          pi-server URL used by pi-client sessions
   PI_SERVER_AUTH_TOKEN   pi-server auth token
-  PI_CLIENT_WEB_CONFIG   pi-client web settings file
+  TAU_HOST               Tau bind host (default: 127.0.0.1)
+  TAU_MIRROR_PORT        Tau port (default: ${defaultPort})
+
+Tau must be installed in the shared Pi agent settings:
+  pi-client install npm:@averyyy/pi-tau-codex
+  # or: pi install npm:@averyyy/pi-tau-codex
+  # dev fallback: pi-client install git:github.com/Averyyy/pi-tau-codex
 `);
 }
+
+function printInstallRequired() {
+	console.error(`请安装 ${tauCodexPackage}:`);
+	console.error("  pi-client install npm:@averyyy/pi-tau-codex");
+	console.error("  # or: pi install npm:@averyyy/pi-tau-codex");
+	console.error("  # dev fallback: pi-client install git:github.com/Averyyy/pi-tau-codex");
+}

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@averyyy/pi-client",
-	"version": "0.80.3",
+	"version": "0.80.6-piclient.5",
 	"description": "Lightweight CLI wrapper that connects to a pi-server instance",
 	"type": "module",
 	"piClient": {
-		"basePiVersion": "0.80.3",
-		"basePiCommit": "85b7c247"
+		"basePiVersion": "0.80.6",
+		"basePiCommit": "2b3fda99"
 	},
 	"bin": {
 		"pi-client": "bin/pi-client.js"
@@ -15,6 +15,7 @@
 	},
 	"files": [
 		"bin",
+		"README.md",
 		"CHANGELOG.md"
 	],
 	"scripts": {
@@ -24,8 +25,7 @@
 		"prepublishOnly": "npm run build"
 	},
 	"dependencies": {
-		"@earendil-works/pi-coding-agent": "0.80.3",
-		"@jmfederico/pi-web": "1.202606.7"
+		"@earendil-works/pi-coding-agent": "npm:@averyyy/pi-coding-agent@0.80.6-piclient.5"
 	},
 	"devDependencies": {
 		"shx": "0.4.0",
@@ -40,7 +40,7 @@
 	"license": "MIT",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/earendil-works/pi.git",
+		"url": "https://github.com/Averyyy/pi-client",
 		"directory": "packages/pi-client"
 	},
 	"engines": {

package/bin/pi-web-plugins/pi-client/package.json

@@ -1,13 +0,0 @@
-{
-	"name": "pi-client-pi-web-plugin",
-	"version": "0.0.0",
-	"type": "module",
-	"piWeb": {
-		"plugins": [
-			{
-				"id": "pi-client",
-				"module": "pi-web-plugin.js"
-			}
-		]
-	}
-}

package/bin/pi-web-plugins/pi-client/pi-web-plugin.js

@@ -1,515 +0,0 @@
-const endpoint = "/api/pi-client/pi-server";
-const agentsEndpoint = "/api/pi-client/global-agents";
-const projectsEndpoint = "/api/pi-client/projects";
-
-function definePiClientServerElements() {
-	if (customElements.get("pi-client-server-panel") !== undefined) return;
-
-	class PiClientServerPanel extends HTMLElement {
-		connectedCallback() {
-			if (this.eventsBound !== true) {
-				this.eventsBound = true;
-				this.addEventListener("click", (event) => {
-					const path = event.composedPath();
-					if (path.some((node) => typeof node?.getAttribute === "function" && node.getAttribute("data-save") !== null)) void this.save(event);
-					if (path.some((node) => typeof node?.getAttribute === "function" && node.getAttribute("data-refresh") !== null)) void this.load();
-				});
-				this.addEventListener("submit", (event) => this.save(event));
-			}
-			this.load();
-		}
-
-		async load() {
-			this.state = { loading: true };
-			this.render();
-			try {
-				const response = await fetch(endpoint);
-				if (!response.ok) throw new Error(response.statusText);
-				this.state = { data: await response.json() };
-			} catch (error) {
-				this.state = { error: error instanceof Error ? error.message : String(error) };
-			}
-			this.render();
-		}
-
-		async save(event) {
-			event?.preventDefault();
-			const input = this.querySelector("input[name='piServerUrl']");
-			if (typeof input?.value !== "string") return;
-			this.state = { ...this.state, saving: true };
-			this.render();
-			try {
-				const response = await fetch(endpoint, {
-					method: "PUT",
-					headers: { "content-type": "application/json" },
-					body: JSON.stringify({ piServerUrl: input.value }),
-				});
-				if (!response.ok) throw new Error((await response.json()).error ?? response.statusText);
-				this.state = { data: await response.json(), saved: true };
-			} catch (error) {
-				this.state = { ...this.state, error: error instanceof Error ? error.message : String(error) };
-			}
-			this.render();
-		}
-
-		render() {
-			const data = this.state?.data;
-			const ready = data?.reachable === true && data?.authenticated !== false;
-			const dot = data === undefined ? "unknown" : ready ? "ok" : "bad";
-			this.innerHTML = `
-				<style>
-					pi-client-server-panel { display: block; color: var(--pi-text); }
-					.pi-client-server-panel { display: grid; gap: 12px; padding: 12px; }
-					.pi-client-server-row { display: flex; align-items: center; gap: 8px; min-width: 0; }
-					.pi-client-server-dot { width: 9px; height: 9px; border-radius: 50%; background: var(--pi-muted); flex: 0 0 auto; }
-					.pi-client-server-dot.ok { background: #2ea043; }
-					.pi-client-server-dot.bad { background: #f85149; }
-					.pi-client-server-panel input { width: 100%; box-sizing: border-box; border: 1px solid var(--pi-border); border-radius: 6px; background: var(--pi-bg); color: var(--pi-text); padding: 8px; }
-					.pi-client-server-panel button { border: 1px solid var(--pi-border); border-radius: 6px; background: var(--pi-surface); color: var(--pi-text); padding: 7px 10px; cursor: pointer; }
-					.pi-client-server-panel button.primary { border-color: var(--pi-accent-border); color: var(--pi-text-bright); }
-					.pi-client-server-panel small, .pi-client-server-panel .muted { color: var(--pi-muted); }
-					.pi-client-server-panel form { display: grid; gap: 8px; }
-					.pi-client-server-actions { display: flex; gap: 8px; flex-wrap: wrap; }
-				</style>
-				<div class="pi-client-server-panel">
-					<div class="pi-client-server-row"><span class="pi-client-server-dot ${dot}"></span><strong>pi-server</strong><small>${escapeHtml(statusText(this.state))}</small></div>
-					<form>
-						<label>
-							<small>Server URL</small>
-							<input name="piServerUrl" value="${escapeAttr(data?.serverUrl ?? "")}" placeholder="http://127.0.0.1:4217" />
-						</label>
-						<div class="pi-client-server-actions">
-							<button class="primary" type="button" data-save>${this.state?.saving === true ? "Saving..." : "Save"}</button>
-							<button type="button" data-refresh>Refresh</button>
-						</div>
-					</form>
-					<small>URL source: ${escapeHtml(data?.urlSource ?? "unknown")} · token: ${data?.tokenConfigured === true ? "configured" : "not configured"}</small>
-					${data?.restartRequired === true ? `<small>Restart pi-client web for saved server URL changes to affect new sessions.</small>` : ""}
-					${this.state?.saved === true ? `<small>Saved.</small>` : ""}
-					${this.state?.error === undefined ? "" : `<small>${escapeHtml(this.state.error)}</small>`}
-				</div>
-			`;
-		}
-	}
-
-	class PiClientServerDialog extends HTMLElement {
-		connectedCallback() {
-			this.render();
-		}
-
-		render() {
-			this.innerHTML = `
-				<style>
-					.pi-client-server-backdrop { position: fixed; inset: 0; z-index: 10000; display: grid; place-items: center; background: rgb(0 0 0 / 0.5); }
-					.pi-client-server-dialog { width: min(520px, calc(100vw - 32px)); border: 1px solid var(--pi-border); border-radius: 8px; background: var(--pi-bg); box-shadow: 0 20px 60px rgb(0 0 0 / 0.35); overflow: hidden; }
-					.pi-client-server-dialog header { display: flex; align-items: center; justify-content: space-between; padding: 10px 12px; border-bottom: 1px solid var(--pi-border); }
-					.pi-client-server-dialog button { border: 1px solid var(--pi-border); border-radius: 6px; background: var(--pi-surface); color: var(--pi-text); padding: 5px 9px; cursor: pointer; }
-				</style>
-				<div class="pi-client-server-backdrop">
-					<section class="pi-client-server-dialog">
-						<header><strong>Pi Server Settings</strong><button type="button" data-close>Close</button></header>
-						<pi-client-server-panel></pi-client-server-panel>
-					</section>
-				</div>
-			`;
-			this.querySelector("[data-close]")?.addEventListener("click", () => this.remove());
-			this.querySelector(".pi-client-server-backdrop")?.addEventListener("click", (event) => {
-				if (event.target === event.currentTarget) this.remove();
-			});
-		}
-	}
-
-	class PiClientServerBadge extends HTMLElement {
-		connectedCallback() {
-			if (this.shadowRoot === null) this.attachShadow({ mode: "open" });
-			this.load();
-			window.addEventListener("focus", this);
-		}
-
-		disconnectedCallback() {
-			window.removeEventListener("focus", this);
-		}
-
-		handleEvent() {
-			this.load();
-		}
-
-		async load() {
-			try {
-				const response = await fetch(endpoint);
-				this.data = response.ok ? await response.json() : { reachable: false };
-			} catch {
-				this.data = { reachable: false };
-			}
-			this.render();
-		}
-
-		render() {
-			const ok = this.data?.reachable === true && this.data?.authenticated !== false;
-			this.shadowRoot.innerHTML = `
-				<style>
-					:host { position: fixed; right: 12px; bottom: 10px; z-index: 1000; }
-					button { display: inline-flex; align-items: center; gap: 6px; border: 1px solid var(--pi-border); border-radius: 999px; background: var(--pi-bg); color: var(--pi-muted); padding: 5px 9px; font-size: 12px; cursor: pointer; }
-					.dot { width: 8px; height: 8px; border-radius: 50%; background: ${ok ? "#2ea043" : "#f85149"}; }
-				</style>
-				<button type="button" title="Pi Server Settings"><span class="dot"></span>pi-server</button>
-			`;
-			this.shadowRoot.querySelector("button")?.addEventListener("click", () => openPiClientServerDialog());
-		}
-	}
-
-	class PiClientAgentsDialog extends HTMLElement {
-		connectedCallback() {
-			if (this.eventsBound !== true) {
-				this.eventsBound = true;
-				this.addEventListener("click", (event) => {
-					const path = event.composedPath();
-					if (path.some((node) => typeof node?.getAttribute === "function" && node.getAttribute("data-close") !== null)) this.remove();
-					if (path.some((node) => typeof node?.getAttribute === "function" && node.getAttribute("data-save-agents") !== null)) void this.save(event);
-				});
-				this.addEventListener("submit", (event) => this.save(event));
-			}
-			this.load();
-		}
-
-		async load() {
-			this.state = { loading: true };
-			this.render();
-			const response = await fetch(agentsEndpoint);
-			if (!response.ok) throw new Error(response.statusText);
-			this.state = { data: await response.json() };
-			this.render();
-		}
-
-		async save(event) {
-			event?.preventDefault();
-			const textarea = this.querySelector("textarea[name='content']");
-			if (typeof textarea?.value !== "string") return;
-			this.state = { ...this.state, saving: true };
-			this.render();
-			const response = await fetch(agentsEndpoint, {
-				method: "PUT",
-				headers: { "content-type": "application/json" },
-				body: JSON.stringify({ content: textarea.value }),
-			});
-			if (!response.ok) throw new Error((await response.json()).error ?? response.statusText);
-			this.state = { data: await response.json(), saved: true };
-			this.render();
-		}
-
-		render() {
-			const data = this.state?.data;
-			this.innerHTML = `
-				<style>
-					.pi-client-agents-backdrop { position: fixed; inset: 0; z-index: 10000; display: grid; place-items: center; background: rgb(0 0 0 / 0.5); }
-					.pi-client-agents-dialog { width: min(840px, calc(100vw - 32px)); max-height: calc(100vh - 32px); display: grid; grid-template-rows: auto minmax(0, 1fr) auto; border: 1px solid var(--pi-border); border-radius: 8px; background: var(--pi-bg); box-shadow: 0 20px 60px rgb(0 0 0 / 0.35); overflow: hidden; color: var(--pi-text); }
-					.pi-client-agents-dialog header, .pi-client-agents-dialog footer { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 10px 12px; border-bottom: 1px solid var(--pi-border); }
-					.pi-client-agents-dialog footer { border-top: 1px solid var(--pi-border); border-bottom: 0; }
-					.pi-client-agents-dialog button { border: 1px solid var(--pi-border); border-radius: 6px; background: var(--pi-surface); color: var(--pi-text); padding: 6px 10px; cursor: pointer; }
-					.pi-client-agents-dialog button.primary { border-color: var(--pi-accent-border); color: var(--pi-text-bright); }
-					.pi-client-agents-dialog small { color: var(--pi-muted); overflow-wrap: anywhere; }
-					.pi-client-agents-dialog textarea { width: 100%; min-height: 420px; height: min(56vh, 640px); resize: vertical; box-sizing: border-box; border: 0; border-bottom: 1px solid var(--pi-border); background: var(--pi-terminal-bg, var(--pi-bg)); color: var(--pi-terminal-text, var(--pi-text)); padding: 12px; font: 13px/1.5 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace; }
-					.pi-client-agents-body { min-height: 0; }
-					.pi-client-agents-actions { display: flex; gap: 8px; align-items: center; }
-				</style>
-				<div class="pi-client-agents-backdrop">
-					<form class="pi-client-agents-dialog">
-						<header><strong>Global AGENTS.md</strong><button type="button" data-close>Close</button></header>
-						<div class="pi-client-agents-body">
-							<textarea name="content" spellcheck="false" ${this.state?.loading === true ? "disabled" : ""}>${escapeHtml(data?.content ?? "")}</textarea>
-						</div>
-						<footer>
-							<small>${escapeHtml(data?.path ?? "Loading...")}</small>
-							<div class="pi-client-agents-actions">
-								${this.state?.saved === true ? `<small>Saved.</small>` : ""}
-								<button class="primary" type="button" data-save-agents>${this.state?.saving === true ? "Saving..." : "Save"}</button>
-							</div>
-						</footer>
-					</form>
-				</div>
-			`;
-			this.querySelector(".pi-client-agents-backdrop")?.addEventListener("click", (event) => {
-				if (event.target === event.currentTarget) this.remove();
-			});
-		}
-	}
-
-	class PiClientProjectsDialog extends HTMLElement {
-		connectedCallback() {
-			if (this.eventsBound !== true) {
-				this.eventsBound = true;
-				this.addEventListener("click", (event) => {
-					const path = event.composedPath();
-					if (path.some((node) => typeof node?.getAttribute === "function" && node.getAttribute("data-close") !== null)) this.remove();
-					const button = path.find((node) => typeof node?.getAttribute === "function" && node.getAttribute("data-project-id") !== null);
-					if (button !== undefined) void this.setVisibility(button.getAttribute("data-project-id"), button.getAttribute("data-visible") === "true");
-				});
-			}
-			this.load();
-		}
-
-		async load() {
-			this.state = { loading: true };
-			this.render();
-			const response = await fetch(projectsEndpoint);
-			if (!response.ok) throw new Error(response.statusText);
-			this.state = { projects: await response.json() };
-			this.render();
-		}
-
-		async setVisibility(projectId, visible) {
-			this.state = { ...this.state, saving: projectId };
-			this.render();
-			const response = await fetch(`${projectsEndpoint}/${encodeURIComponent(projectId)}/visibility`, {
-				method: "PUT",
-				headers: { "content-type": "application/json" },
-				body: JSON.stringify({ visible }),
-			});
-			if (!response.ok) throw new Error((await response.json()).error ?? response.statusText);
-			this.state = { projects: await response.json(), saved: true };
-			this.render();
-		}
-
-		render() {
-			const projects = this.state?.projects ?? [];
-			this.innerHTML = `
-				<style>
-					.pi-client-projects-backdrop { position: fixed; inset: 0; z-index: 10000; display: grid; place-items: center; background: rgb(0 0 0 / 0.5); }
-					.pi-client-projects-dialog { width: min(720px, calc(100vw - 32px)); max-height: calc(100vh - 32px); display: grid; grid-template-rows: auto minmax(0, 1fr) auto; border: 1px solid var(--pi-border); border-radius: 8px; background: var(--pi-bg); box-shadow: 0 20px 60px rgb(0 0 0 / 0.35); overflow: hidden; color: var(--pi-text); }
-					.pi-client-projects-dialog header, .pi-client-projects-dialog footer { display: flex; align-items: center; justify-content: space-between; gap: 8px; padding: 10px 12px; border-bottom: 1px solid var(--pi-border); }
-					.pi-client-projects-dialog footer { border-top: 1px solid var(--pi-border); border-bottom: 0; }
-					.pi-client-projects-dialog button { border: 1px solid var(--pi-border); border-radius: 6px; background: var(--pi-surface); color: var(--pi-text); padding: 6px 10px; cursor: pointer; }
-					.pi-client-projects-dialog small { color: var(--pi-muted); overflow-wrap: anywhere; }
-					.pi-client-projects-list { overflow: auto; }
-					.pi-client-project-row { display: grid; grid-template-columns: minmax(0, 1fr) auto auto; gap: 10px; align-items: center; padding: 10px 12px; border-bottom: 1px solid var(--pi-border-muted, var(--pi-border)); }
-					.pi-client-project-row strong { display: block; }
-					.pi-client-project-empty { padding: 18px 12px; color: var(--pi-muted); }
-				</style>
-				<div class="pi-client-projects-backdrop">
-					<section class="pi-client-projects-dialog">
-						<header><strong>Project Visibility</strong><button type="button" data-close>Close</button></header>
-						<div class="pi-client-projects-list">
-							${
-								this.state?.loading === true
-									? `<div class="pi-client-project-empty">Loading...</div>`
-									: projects.length === 0
-										? `<div class="pi-client-project-empty">No projects yet.</div>`
-										: projects.map((project) => projectRow(project, this.state?.saving)).join("")
-							}
-						</div>
-						<footer><small>Visible projects appear in the PI WEB sidebar.</small>${this.state?.saved === true ? `<small>Saved.</small>` : ""}</footer>
-					</section>
-				</div>
-			`;
-			this.querySelector(".pi-client-projects-backdrop")?.addEventListener("click", (event) => {
-				if (event.target === event.currentTarget) this.remove();
-			});
-		}
-	}
-
-	class PiClientQuickbar extends HTMLElement {
-		connectedCallback() {
-			if (this.shadowRoot === null) this.attachShadow({ mode: "open" });
-			this.render();
-		}
-
-		render() {
-			this.shadowRoot.innerHTML = `
-				<style>
-					:host { display: block; border-bottom: 1px solid var(--pi-border); padding: 8px 10px; }
-					.pi-client-quickbar { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 6px; }
-					button { min-width: 0; border: 1px solid var(--pi-border); border-radius: 6px; background: var(--pi-surface); color: var(--pi-text); padding: 6px 4px; font-size: 12px; line-height: 1; cursor: pointer; }
-				</style>
-				<div class="pi-client-quickbar">
-					<button type="button" title="New Conversation" data-action="new">New</button>
-					<button type="button" title="Search" data-action="search">Search</button>
-					<button type="button" title="Skill Management" data-action="skills">Skills</button>
-					<button type="button" title="Global AGENTS.md" data-action="agents">AGENTS</button>
-				</div>
-			`;
-			this.shadowRoot.querySelectorAll("button").forEach((button) => {
-				button.addEventListener("click", () => runQuickbarAction(button.getAttribute("data-action")));
-			});
-		}
-	}
-
-	customElements.define("pi-client-server-panel", PiClientServerPanel);
-	customElements.define("pi-client-server-dialog", PiClientServerDialog);
-	customElements.define("pi-client-server-badge", PiClientServerBadge);
-	customElements.define("pi-client-agents-dialog", PiClientAgentsDialog);
-	customElements.define("pi-client-projects-dialog", PiClientProjectsDialog);
-	customElements.define("pi-client-quickbar", PiClientQuickbar);
-}
-
-function openPiClientServerDialog() {
-	document.querySelector("pi-client-server-dialog")?.remove();
-	document.body.append(document.createElement("pi-client-server-dialog"));
-}
-
-function openPiClientAgentsDialog() {
-	document.querySelector("pi-client-agents-dialog")?.remove();
-	document.body.append(document.createElement("pi-client-agents-dialog"));
-}
-
-function openPiClientProjectsDialog() {
-	document.querySelector("pi-client-projects-dialog")?.remove();
-	document.body.append(document.createElement("pi-client-projects-dialog"));
-}
-
-function installBadge() {
-	if (document.querySelector("pi-client-server-badge") !== null) return;
-	document.body.append(document.createElement("pi-client-server-badge"));
-}
-
-function installQuickbar() {
-	const root = document.querySelector("pi-web-app")?.shadowRoot?.querySelector("app-navigation-panel")?.shadowRoot;
-	if (root === undefined || root === null) {
-		window.requestAnimationFrame(installQuickbar);
-		return;
-	}
-	if (root.querySelector("pi-client-quickbar") === null) root.querySelector("header")?.after(document.createElement("pi-client-quickbar"));
-	if (window.piClientQuickbarObserver !== undefined) return;
-	window.piClientQuickbarObserver = new MutationObserver(() => {
-		if (root.querySelector("pi-client-quickbar") === null) root.querySelector("header")?.after(document.createElement("pi-client-quickbar"));
-	});
-	window.piClientQuickbarObserver.observe(root, { childList: true });
-}
-
-function runQuickbarAction(action) {
-	const context = piWebContext();
-	if (action === "new") {
-		if (context.state.selectedWorkspace === undefined) {
-			context.addProject();
-		} else {
-			void context.startSession();
-		}
-	}
-	if (action === "search") context.openActionPalette();
-	if (action === "skills") context.piWebUnstable.openSettings("plugins");
-	if (action === "agents") openPiClientAgentsDialog();
-}
-
-function piWebContext() {
-	// ponytail: PI WEB exposes runtime helpers to actions but not fixed toolbar slots yet.
-	return document.querySelector("pi-web-app").createPluginRuntimeContext();
-}
-
-function projectRow(project, savingProjectId) {
-	const visible = project.hidden !== true;
-	const saving = savingProjectId === project.id;
-	return `
-		<div class="pi-client-project-row">
-			<div>
-				<strong>${escapeHtml(project.name)}</strong>
-				<small>${escapeHtml(project.path)}</small>
-			</div>
-			<small>${visible ? "Visible" : "Hidden"}</small>
-			<button type="button" data-project-id="${escapeAttr(project.id)}" data-visible="${visible ? "false" : "true"}">${saving ? "Saving..." : visible ? "Hide" : "Show"}</button>
-		</div>
-	`;
-}
-
-function statusText(state) {
-	if (state?.loading === true) return "checking";
-	if (state?.error !== undefined) return state.error;
-	if (state?.data === undefined) return "unknown";
-	if (state.data.reachable !== true) return "offline";
-	if (state.data.authenticated === false) return "auth failed";
-	return "online";
-}
-
-function escapeHtml(value) {
-	return String(value).replace(/[&<>"']/gu, (char) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[char]);
-}
-
-function escapeAttr(value) {
-	return escapeHtml(value);
-}
-
-const plugin = {
-	apiVersion: 1,
-	name: "pi-client",
-	activate: ({ html, svg }) => {
-		definePiClientServerElements();
-		queueMicrotask(installBadge);
-		queueMicrotask(installQuickbar);
-		return {
-			contributions: {
-				actions: [
-					{
-						id: "pi-client.add-project",
-						title: "Add Project",
-						description: "Add a local folder to the pi-client web sidebar.",
-						group: "Pi Client",
-						run: (context) => context.addProject(),
-					},
-					{
-						id: "pi-client.new-conversation",
-						title: "New Conversation",
-						description: "Start a new pi-client session in the selected workspace.",
-						group: "Pi Client",
-						enabled: (context) => context.state.selectedWorkspace !== undefined,
-						disabledReason: () => "Select a workspace first.",
-						run: (context) => context.startSession(),
-					},
-					{
-						id: "pi-client.search",
-						title: "Search",
-						description: "Open PI WEB's action search.",
-						group: "Pi Client",
-						run: (context) => context.openActionPalette(),
-					},
-					{
-						id: "pi-client.skill-management",
-						title: "Skill Management",
-						description: "Open PI WEB plugin management.",
-						group: "Pi Client",
-						run: (context) => context.piWebUnstable.openSettings("plugins"),
-					},
-					{
-						id: "pi-client.project-visibility",
-						title: "Project Visibility",
-						description: "Hide or show projects in the pi-client web sidebar.",
-						group: "Pi Client",
-						run: openPiClientProjectsDialog,
-					},
-					{
-						id: "pi-client.global-agents",
-						title: "Global AGENTS.md",
-						description: "Edit the shared pi-client AGENTS.md file.",
-						group: "Pi Client",
-						run: openPiClientAgentsDialog,
-					},
-					{
-						id: "pi-client.open-pi-server-settings",
-						title: "Pi Server Settings",
-						description: "Configure the pi-server URL used by pi-client web sessions.",
-						group: "Pi Client",
-						run: openPiClientServerDialog,
-					},
-				],
-				workspacePanels: [
-					{
-						id: "pi-client.server",
-						title: "Pi Server",
-						icon: svg`
-							<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-								<path d="M12 2v6"></path>
-								<path d="M12 16v6"></path>
-								<path d="M4.9 4.9l4.2 4.2"></path>
-								<path d="M14.9 14.9l4.2 4.2"></path>
-								<path d="M2 12h6"></path>
-								<path d="M16 12h6"></path>
-								<circle cx="12" cy="12" r="4"></circle>
-							</svg>
-						`,
-						order: 5,
-						render: () => html`<pi-client-server-panel></pi-client-server-panel>`,
-					},
-				],
-			},
-		};
-	},
-};
-
-export default plugin;