osdy-pi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Osdy
+
+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,98 @@
+# osdy-pi
+
+Pi package for the Osdy terminal experience.
+
+## Features
+
+- `osdy-pi-dark` neon pink/purple theme enabled by default on `session_start`.
+- `osdy-pi-light` neon pink/purple companion theme included.
+- Centered custom Osdy-Pi ASCII header with responsive Git, path, MCP, plugins, AGENTS, extensions, Pi version, and tools status.
+- Custom editor with four internal lines by default and smaller responsive fallback.
+- Full-width Osdy editor frame with complete top, bottom, and side borders in normal terminal widths.
+- Editor border status:
+  - top-right: current model and thinking level;
+  - bottom-left: input/output/cache tokens, accumulated cost, and context percentage/window.
+- Animation disabled.
+
+## Install
+
+Pi packages are not uploaded to a separate Pi registry. They are shared through npm, git, or a local path.
+
+### From npm
+
+After publishing this package to npm:
+
+```bash
+pi install npm:osdy-pi
+```
+
+### From GitHub
+
+After pushing this package to a GitHub repository:
+
+```bash
+pi install git:github.com/<owner>/osdy-pi
+```
+
+You can also pin a tag or branch:
+
+```bash
+pi install git:github.com/<owner>/osdy-pi@v0.1.0
+```
+
+### Local development
+
+To test this package from this repository without installing it permanently:
+
+```bash
+pi -e .
+```
+
+To install it from a local path:
+
+```bash
+pi install /absolute/path/to/osdy-pi
+```
+
+## Publishing
+
+### npm
+
+```bash
+npm login
+npm pack --dry-run
+npm publish
+```
+
+Then verify with:
+
+```bash
+pi install npm:osdy-pi
+```
+
+### GitHub
+
+Initialize the repository, commit the package, push it to GitHub, then install it with the `git:` source shown above.
+
+## Commands
+
+```text
+/osdy-pi enable
+/osdy-pi disable
+/osdy-pi status
+```
+
+`enable` applies the `osdy-pi-dark` theme, custom header, custom editor, and hides the built-in footer/working row to avoid duplicate status UI.
+
+`disable` restores the built-in header, editor, footer, and working visibility, then switches back to the previously captured theme or `dark`.
+
+## Package resources
+
+The Pi manifest is declared in `package.json`:
+
+- themes: `themes/osdy-pi-dark.json`, `themes/osdy-pi-light.json`
+- extension: `extensions/osdy-pi.ts`
+
+## License
+
+MIT

package/extensions/osdy-pi.ts

@@ -0,0 +1,623 @@
+import {
+	CustomEditor,
+	VERSION,
+	type ExtensionAPI,
+	type ExtensionContext,
+	type KeybindingsManager,
+} from "@earendil-works/pi-coding-agent";
+import {
+	truncateToWidth,
+	visibleWidth,
+	type Component,
+	type EditorTheme,
+	type TUI,
+} from "@earendil-works/pi-tui";
+
+const THEME_NAME = "osdy-pi-dark";
+const ANIMATION_ENABLED = true;
+const ANIMATION_INTERVAL_MS = 30;
+const INTRO_ANIMATION_FRAMES = 28;
+
+type AnimationMode = "off" | "intro" | "continuous";
+
+type OsdyState = {
+	enabled: boolean;
+	previousThemeName?: string;
+	gitLabel: string;
+	agentsLabel: string;
+};
+
+const MASCOT_MIN_ROWS = 34;
+const MASCOT_GAP = 0;
+
+const MASCOT = [
+	"                  %%  %%%@@             @@%%% @%%",
+	"                 %= --- -=#% @@@@@@@@@%%%-- ----#%",
+	"                 %- -*#@ =+**-------:-**- %%#*--#%",
+	"                 %- -*#%*-----------------*%#*--#%",
+	"                  %+-#*---------------------**-+%",
+	"                   %#=--=-  ==-------=   ----=*%",
+	"                  %+--  ***** ------  ****   -=*%",
+	"                @%%  ****%% %*=-----**% %****# #%%@",
+	"               @%# ******%%%%*=--==-**%%%%*****#--%",
+	"                %%#*******##*# %%%%  **%#*******%%@",
+	"                  %%%#******  %@%%@%   ******#%@%",
+	"                     %%%::               ::#%@    %%%%%",
+	"                        %%%**::::::::::%%%     %%#-****%%",
+	"                       %#---: :   :: ::-=+%%%%%=-::::+*#%",
+	"                      %%----- :     ::----*%%%*****-:::#%",
+	"                      #*------ :   ::-----**#+-:=+***=-*%",
+	"                   %%%+*=+------ ::------+*=+%-:::-*##+%%",
+	"                   %*---**-----*  **----+*--=+%=---=*#%",
+	"                   %**+==%*----*==%=----##==+*%#+--*%%",
+	"                    %%#%#%@+=+++%%++++==%##%#%#%%%%",
+	"                ----=+%%%#%%#%*##%###*#%%##%%==---------",
+	"                           ##****=*****==",
+];
+const MASCOT_WIDTH = MASCOT.reduce(
+	(maxWidth, line) => Math.max(maxWidth, visibleWidth(line)),
+	0,
+);
+
+type HeaderMetaRow = {
+	leftLabel: string;
+	leftValue: string;
+	rightLabel: string;
+	rightValue: string;
+};
+
+const HEADER = [
+	"░█████╗░░██████╗██████╗░██╗░░░██╗░░░░░░██████╗░██╗",
+	"██╔══██╗██╔════╝██╔══██╗╚██╗░██╔╝░░░░░░██╔══██╗  ║",
+	"██║░░██║╚█████╗░██║░░██║░╚████╔╝░█████╗██████╔╝██║",
+	"██║░░██║░╚═══██╗██║░░██║░░╚██╔╝░░╚════╝██╔═══╝░██║",
+	"╚█████╔╝██████╔╝██████╔╝░░░██║░░░░░░░░░██║░░░░░██║",
+	"░╚════╝░╚═════╝░╚═════╝░░░░╚═╝░░░░░░░░░╚═╝░░░░░╚═╝",
+	"                                ╭━╮╱╱╱╱╱╱╭╮╱╱╱╱╱╭╮╱╱╱╱╱╭╮╱╱╭╮╭╮╱╱╱╱╭━╮",
+	"                                ┃╭╋━┳━━┳━╋╋╮╭━╮╭╯┣━┳┳╮╭╯┣━╮┣╋╯┣━┳━╮┃━┫",
+	"                                ┃╰┫╋┃┃┃┃╋┃┃╰┫╋╰┫╋┃╋┃╭╯┃╋┃┻┫┃┃╋┃┻┫╋╰╋━┃",
+	"                                ╰━┻━┻┻┻┫╭┻┻━┻━━┻━┻━┻╯╱╰━┻━╯╰┻━┻━┻━━┻━╯",
+	"                                ╱╱╱╱╱╱╱╰╯                        </>",
+];
+const HEADER_WIDTH = HEADER.reduce(
+	(maxWidth, line) => Math.max(maxWidth, visibleWidth(line)),
+	0,
+);
+const HEADER_FALLBACK = ["OSDY - PI", "</> Compilador de ideas"];
+
+class OsdyFooter implements Component {
+	constructor(
+		private readonly ctx: ExtensionContext,
+		private readonly footerData: any,
+		private readonly theme: { fg(name: string, text: string): string },
+	) {}
+
+	render(width: number): string[] {
+		let location = formatPath(this.ctx.cwd);
+		const branch = this.footerData.getGitBranch?.();
+		if (branch) location = `${location} (${branch})`;
+		const locationLine = truncateToWidth(
+			this.theme.fg("dim", location),
+			width,
+			this.theme.fg("dim", "..."),
+		);
+		const statuses = this.footerData.getExtensionStatuses?.() ?? new Map();
+		const statusEntries = Array.from(statuses.entries()) as Array<
+			[string, string]
+		>;
+		const statusLine = statusEntries
+			.sort(([leftKey], [rightKey]) => leftKey.localeCompare(rightKey))
+			.map(([, text]) => sanitizeStatusText(text))
+			.join(" ");
+		return statusLine
+			? [
+					locationLine,
+					truncateToWidth(statusLine, width, this.theme.fg("dim", "...")),
+				]
+			: [locationLine];
+	}
+
+	invalidate(): void {}
+}
+
+function sanitizeStatusText(text: string): string {
+	return text
+		.replace(/[\r\n\t]/g, " ")
+		.replace(/ +/g, " ")
+		.trim();
+}
+
+function positiveModulo(value: number, divisor: number): number {
+	return ((value % divisor) + divisor) % divisor;
+}
+
+function asciiAnimationMode(): AnimationMode {
+	if (!ANIMATION_ENABLED) return "off";
+	const override = process.env.OSDY_PI_ANIMATION;
+	if (override === "1" || override === "on" || override === "continuous")
+		return "continuous";
+	if (override === "intro") return "intro";
+	if (override === "0" || override === "off") return "off";
+	return "intro";
+}
+
+function animateAsciiLine(
+	line: string,
+	lineIndex: number,
+	frame: number,
+	theme: { fg(name: string, text: string): string },
+	baseColor: string,
+	highlightColor: string,
+	trailColor: string,
+	animate: boolean,
+): string {
+	if (!animate) return theme.fg(baseColor, line);
+	return [...line]
+		.map((char, charIndex) => {
+			if (char === " ") return char;
+			const wave = positiveModulo(charIndex + lineIndex * 2 - frame * 5, 44);
+			const color =
+				wave <= 3 ? highlightColor : wave <= 8 ? trailColor : baseColor;
+			return theme.fg(color, char);
+		})
+		.join("");
+}
+
+function centerVisible(line: string, width: number): string {
+	const leftPad = Math.max(0, Math.floor((width - visibleWidth(line)) / 2));
+	return `${" ".repeat(leftPad)}${line}`;
+}
+
+function fitCenterVisible(line: string, width: number): string {
+	return centerVisible(truncateToWidth(line, Math.max(1, width)), width);
+}
+
+function padVisibleRight(line: string, width: number): string {
+	return `${line}${" ".repeat(Math.max(0, width - visibleWidth(line)))}`;
+}
+
+function composeSideBySide(
+	leftLines: string[],
+	rightLines: string[],
+	width: number,
+): string[] {
+	const combinedWidth = MASCOT_WIDTH + MASCOT_GAP + HEADER_WIDTH;
+	if (width < combinedWidth) return rightLines;
+	const leftPad = " ".repeat(
+		Math.max(0, Math.floor((width - combinedWidth) / 2)),
+	);
+	const rows = Math.max(leftLines.length, rightLines.length);
+	const topOffset = Math.max(0, Math.floor((rows - rightLines.length) / 2));
+	return Array.from({ length: rows }, (_, index) => {
+		const left = padVisibleRight(leftLines[index] ?? "", MASCOT_WIDTH);
+		const right = rightLines[index - topOffset] ?? "";
+		return `${leftPad}${left}${" ".repeat(MASCOT_GAP)}${right}`;
+	});
+}
+
+function formatPath(cwd: string) {
+	const home = process.env.HOME;
+	return home && cwd.startsWith(home) ? `~${cwd.slice(home.length)}` : cwd;
+}
+
+function truncateMiddle(value: string, maxWidth: number): string {
+	if (maxWidth <= 0) return "";
+	if (visibleWidth(value) <= maxWidth) return value;
+	if (maxWidth <= 3) return truncateToWidth(value, maxWidth);
+	const headWidth = Math.max(1, Math.ceil((maxWidth - 1) / 2));
+	const tailWidth = Math.max(1, maxWidth - 1 - headWidth);
+	const head = truncateToWidth(value, headWidth, "");
+	const tail = truncateToWidth([...value].reverse().join(""), tailWidth, "")
+		.split("")
+		.reverse()
+		.join("");
+	return `${head}…${tail}`;
+}
+
+function shortNumber(value: number): string {
+	if (!Number.isFinite(value)) return "0";
+	if (Math.abs(value) < 1_000) return Math.round(value).toString();
+	if (Math.abs(value) < 1_000_000) return `${(value / 1_000).toFixed(1)}k`;
+	return `${(value / 1_000_000).toFixed(1)}m`;
+}
+
+function modelLabel(ctx: ExtensionContext): string {
+	const model = ctx.model;
+	if (!model) return "no model";
+	return model.provider ? `${model.provider}/${model.id}` : model.id;
+}
+
+function getMcpServerCount(pi: ExtensionAPI): number {
+	const serverKeys = new Set<string>();
+	for (const tool of pi.getAllTools()) {
+		const source = tool.sourceInfo?.source?.toLowerCase() ?? "";
+		const path = tool.sourceInfo?.path?.toLowerCase() ?? "";
+		if (!tool.name.toLowerCase().includes("mcp") && !source.includes("mcp"))
+			continue;
+		serverKeys.add(source || path || tool.name);
+	}
+	return serverKeys.size;
+}
+
+function countToolsByOrigin(pi: ExtensionAPI, origin: string): number {
+	return pi
+		.getAllTools()
+		.filter((tool) => tool.sourceInfo?.origin?.toLowerCase() === origin).length;
+}
+
+function countToolsBySource(pi: ExtensionAPI, source: string): number {
+	return pi
+		.getAllTools()
+		.filter((tool) => tool.sourceInfo?.source?.toLowerCase().includes(source))
+		.length;
+}
+
+function renderHeaderMetadata(
+	pi: ExtensionAPI,
+	ctx: ExtensionContext,
+	state: OsdyState,
+	width: number,
+): HeaderMetaRow[] {
+	const activeTools = pi.getActiveTools().length;
+	const allTools = pi.getAllTools().length;
+	const git = state.gitLabel === "no-git" ? "Not a git repo" : state.gitLabel;
+	const path = truncateMiddle(formatPath(ctx.cwd), width < 110 ? 34 : 52);
+	const mcpServerCount = getMcpServerCount(pi);
+	const pluginCount = countToolsByOrigin(pi, "package");
+	const extensionCount = countToolsBySource(pi, "extension");
+	return [
+		{
+			leftLabel: "GIT:",
+			leftValue: git,
+			rightLabel: "PATH:",
+			rightValue: path,
+		},
+		{
+			leftLabel: "MCP:",
+			leftValue: `${mcpServerCount} servers`,
+			rightLabel: "PLUGINS:",
+			rightValue: `${pluginCount} package`,
+		},
+		{
+			leftLabel: "AGENTS:",
+			leftValue: `${state.agentsLabel} loaded`,
+			rightLabel: "EXTENSIONS:",
+			rightValue: `${extensionCount} active`,
+		},
+		{
+			leftLabel: "VER:",
+			leftValue: VERSION,
+			rightLabel: "TOOLS:",
+			rightValue: `${allTools} customs`,
+		},
+	];
+}
+
+function renderMetaRows(
+	rows: HeaderMetaRow[],
+	width: number,
+	theme: { fg(name: string, text: string): string },
+): string[] {
+	const labelWidth = 11;
+	const leftValueWidth = 32;
+	const rightValueWidth = 52;
+	const gapWidth = 10;
+	const blockWidth =
+		labelWidth +
+		1 +
+		leftValueWidth +
+		gapWidth +
+		labelWidth +
+		1 +
+		rightValueWidth;
+	return rows.map((row) => {
+		const leftLabel = theme.fg("mdLink", row.leftLabel.padEnd(labelWidth));
+		const leftValue = theme.fg(
+			"accent",
+			truncateToWidth(row.leftValue, leftValueWidth).padEnd(leftValueWidth),
+		);
+		const rightLabel = theme.fg("mdLink", row.rightLabel.padEnd(labelWidth));
+		const rightValue = theme.fg(
+			"accent",
+			truncateToWidth(row.rightValue, rightValueWidth).padEnd(rightValueWidth),
+		);
+		const rowText = `${leftLabel} ${leftValue}${" ".repeat(gapWidth)}${rightLabel} ${rightValue}`;
+		return width >= blockWidth
+			? centerVisible(rowText, width)
+			: fitCenterVisible(rowText, width);
+	});
+}
+
+function usageLabel(ctx: ExtensionContext): string {
+	let input = 0;
+	let output = 0;
+	let cacheRead = 0;
+	let cacheWrite = 0;
+	let cost = 0;
+	for (const entry of ctx.sessionManager.getEntries()) {
+		const anyEntry = entry as any;
+		if (anyEntry.type !== "message" || anyEntry.message?.role !== "assistant")
+			continue;
+		const usage = anyEntry.message.usage;
+		if (!usage) continue;
+		input += usage.input ?? 0;
+		output += usage.output ?? 0;
+		cacheRead += usage.cacheRead ?? 0;
+		cacheWrite += usage.cacheWrite ?? 0;
+		cost += usage.cost?.total ?? 0;
+	}
+	const context = ctx.getContextUsage();
+	const contextWindow = context?.contextWindow ?? ctx.model?.contextWindow;
+	const percent = context?.percent ?? null;
+	const ctxText = contextWindow
+		? `ctx ${percent === null ? "?" : Math.round(percent)}%/${shortNumber(contextWindow)}`
+		: "ctx ?";
+	const cacheText =
+		cacheRead || cacheWrite
+			? ` R${shortNumber(cacheRead)} W${shortNumber(cacheWrite)}`
+			: "";
+	return ` tok ↑${shortNumber(input)} ↓${shortNumber(output)}${cacheText} · $${cost.toFixed(4)} · ${ctxText} `;
+}
+
+function fitBorder(
+	left: string,
+	right: string,
+	width: number,
+	color: (text: string) => string,
+): string {
+	if (width <= 0) return "";
+	if (width === 1) return color("─");
+	let leftText = left;
+	let rightText = right;
+	const fixedWidth = 2;
+	const minGap = 1;
+	while (
+		fixedWidth + visibleWidth(leftText) + visibleWidth(rightText) + minGap >
+			width &&
+		visibleWidth(rightText) > 0
+	) {
+		rightText = truncateToWidth(
+			rightText,
+			Math.max(0, visibleWidth(rightText) - 1),
+			"",
+		);
+	}
+	while (
+		fixedWidth + visibleWidth(leftText) + visibleWidth(rightText) + minGap >
+			width &&
+		visibleWidth(leftText) > 0
+	) {
+		leftText = truncateToWidth(
+			leftText,
+			Math.max(0, visibleWidth(leftText) - 1),
+			"",
+		);
+	}
+	const fillWidth = Math.max(
+		0,
+		width - fixedWidth - visibleWidth(leftText) - visibleWidth(rightText),
+	);
+	return `${color("─")}${leftText}${color("─".repeat(fillWidth))}${rightText}${color("─")}`;
+}
+
+function internalLineTarget(tui: TUI): number {
+	return tui.terminal.rows < 18 ? 3 : 4;
+}
+
+function applyOsdyPi(
+	pi: ExtensionAPI,
+	ctx: ExtensionContext,
+	state: OsdyState,
+	notify = false,
+): void {
+	if (!ctx.hasUI) return;
+	const currentTheme = ctx.ui.theme.name;
+	if (!state.previousThemeName && currentTheme && currentTheme !== THEME_NAME)
+		state.previousThemeName = currentTheme;
+	const osdyTheme = ctx.ui.getTheme(THEME_NAME);
+	const themeResult = osdyTheme
+		? ctx.ui.setTheme(osdyTheme)
+		: ctx.ui.setTheme(THEME_NAME);
+	if (!themeResult.success)
+		ctx.ui.notify(
+			`osdy-pi theme failed: ${themeResult.error ?? "unknown error"}`,
+			"warning",
+		);
+
+	ctx.ui.setHeader((_tui, theme) => {
+		let frame = 0;
+		let animationComplete = false;
+		const animationMode = asciiAnimationMode();
+		const animateAscii = animationMode !== "off";
+		const timer = animateAscii
+			? setInterval(() => {
+					frame += 1;
+					if (animationMode === "intro" && frame >= INTRO_ANIMATION_FRAMES) {
+						animationComplete = true;
+						clearInterval(timer);
+					}
+					_tui.requestRender();
+				}, ANIMATION_INTERVAL_MS)
+			: undefined;
+		return {
+			render(width: number): string[] {
+				const animateFrame = animateAscii && !animationComplete;
+				const showMascot =
+					_tui.terminal.rows >= MASCOT_MIN_ROWS &&
+					width >= MASCOT_WIDTH + MASCOT_GAP + HEADER_WIDTH;
+				const useFullHeader = width >= HEADER_WIDTH;
+				const headerLines = useFullHeader ? HEADER : HEADER_FALLBACK;
+				const metadataRows = renderHeaderMetadata(pi, ctx, state, width);
+				const logoLines = headerLines.map((line, index) => {
+					const baseColor = useFullHeader && index >= 6 ? "mdLink" : "accent";
+					return animateAsciiLine(
+						line,
+						index,
+						frame,
+						theme,
+						baseColor,
+						"mdHeading",
+						"mdLink",
+						animateFrame,
+					);
+				});
+				const mascotLines = MASCOT.map((line, index) =>
+					animateAsciiLine(
+						line,
+						index,
+						frame,
+						theme,
+						"muted",
+						"mdCode",
+						"muted",
+						animateFrame,
+					),
+				);
+				const headerBlock = showMascot
+					? composeSideBySide(mascotLines, logoLines, width)
+					: logoLines.map((line) =>
+							useFullHeader
+								? centerVisible(line, width)
+								: fitCenterVisible(line, width),
+						);
+				return [
+					"",
+					...headerBlock,
+					"",
+					...renderMetaRows(metadataRows, width, theme),
+					"",
+				];
+			},
+			invalidate() {},
+			dispose() {
+				if (timer) clearInterval(timer);
+			},
+		};
+	});
+	ctx.ui.setFooter(
+		(_tui, theme, footerData) => new OsdyFooter(ctx, footerData, theme),
+	);
+	ctx.ui.setWorkingVisible(false);
+
+	class OsdyEditor extends CustomEditor {
+		constructor(
+			private readonly tuiRef: TUI,
+			theme: EditorTheme,
+			keybindings: KeybindingsManager,
+		) {
+			super(tuiRef, theme, keybindings, { paddingX: 1 });
+		}
+		render(width: number): string[] {
+			if (width < 4 || this.isShowingAutocomplete()) return super.render(width);
+			const editorWidth = width;
+			const innerWidth = Math.max(1, editorWidth - 2);
+			const lines = super.render(innerWidth);
+			if (lines.length < 2) return lines;
+			let bottomIndex = Math.max(1, lines.length - 1);
+			const target = internalLineTarget(this.tuiRef);
+			const internalLines = bottomIndex - 1;
+			if (internalLines < target) {
+				const blank = " ".repeat(innerWidth);
+				const added = Array.from(
+					{ length: target - internalLines },
+					() => blank,
+				);
+				lines.splice(bottomIndex, 0, ...added);
+				bottomIndex += added.length;
+			}
+			const borderColor = (text: string) => this.borderColor(text);
+			const side = borderColor("│");
+			for (let i = 1; i < bottomIndex; i += 1) {
+				const content = truncateToWidth(lines[i], innerWidth, "");
+				const padding = " ".repeat(
+					Math.max(0, innerWidth - visibleWidth(content)),
+				);
+				lines[i] = `${side}${content}${padding}${side}`;
+			}
+			const topLeft = ctx.ui.theme.fg("mdLink", " Osdy-Pi ");
+			const topRight = ctx.ui.theme.fg(
+				"muted",
+				` ${modelLabel(ctx)} · think ${pi.getThinkingLevel()} `,
+			);
+			const bottomLeft = ctx.ui.theme.fg("muted", usageLabel(ctx));
+			lines[0] = `${borderColor("╭")}${fitBorder(topLeft, topRight, editorWidth - 2, borderColor)}${borderColor("╮")}`;
+			lines[bottomIndex] =
+				`${borderColor("╰")}${fitBorder(bottomLeft, "", editorWidth - 2, borderColor)}${borderColor("╯")}`;
+			return lines;
+		}
+	}
+	ctx.ui.setEditorComponent(
+		(tui, theme, keybindings) => new OsdyEditor(tui, theme, keybindings),
+	);
+	if (notify) ctx.ui.notify("osdy-pi enabled", "info");
+}
+
+function disableOsdyPi(ctx: ExtensionContext, state: OsdyState): void {
+	if (!ctx.hasUI) return;
+	ctx.ui.setHeader(undefined);
+	ctx.ui.setEditorComponent(undefined);
+	ctx.ui.setFooter(undefined);
+	ctx.ui.setWorkingVisible(true);
+	const targetTheme = state.previousThemeName ?? "dark";
+	const result = ctx.ui.setTheme(targetTheme);
+	if (!result.success && targetTheme !== "dark") ctx.ui.setTheme("dark");
+	ctx.ui.notify("osdy-pi disabled", "info");
+}
+
+export default function (pi: ExtensionAPI) {
+	const state: OsdyState = { enabled: true, gitLabel: "-", agentsLabel: "-" };
+	pi.on("session_start", (_event, ctx) => {
+		void pi
+			.exec("git", ["branch", "--show-current"], { cwd: ctx.cwd })
+			.then((result) => {
+				state.gitLabel = result.stdout.trim() || "detached";
+			})
+			.catch(() => {
+				state.gitLabel = "no-git";
+			});
+		void pi
+			.exec(
+				"find",
+				[ctx.cwd, "-name", "AGENTS.md", "-o", "-name", "AGENTS.MD"],
+				{ cwd: ctx.cwd },
+			)
+			.then((result) => {
+				state.agentsLabel = String(
+					result.stdout.split("\n").filter(Boolean).length,
+				);
+			})
+			.catch(() => {
+				state.agentsLabel = "0";
+			});
+		if (state.enabled) applyOsdyPi(pi, ctx, state);
+	});
+	pi.registerCommand("osdy-pi", {
+		description: "Manage the Osdy Pi experience: enable, disable, or status.",
+		getArgumentCompletions(prefix: string) {
+			return ["enable", "disable", "status"]
+				.filter((value) => value.startsWith(prefix.trim()))
+				.map((value) => ({ value, label: value }));
+		},
+		handler: async (args, ctx) => {
+			const action = args.trim().split(/\s+/, 1)[0] || "status";
+			if (action === "enable") {
+				state.enabled = true;
+				applyOsdyPi(pi, ctx, state, true);
+				return;
+			}
+			if (action === "disable") {
+				state.enabled = false;
+				disableOsdyPi(ctx, state);
+				return;
+			}
+			if (action !== "status") {
+				ctx.ui.notify("Usage: /osdy-pi enable | disable | status", "warning");
+				return;
+			}
+			ctx.ui.notify(
+				`osdy-pi ${state.enabled ? "enabled" : "disabled"} · theme ${ctx.ui.theme.name ?? "unknown"} · animation ${asciiAnimationMode()} · ${modelLabel(ctx)} · ${usageLabel(ctx).trim()}`,
+				"info",
+			);
+		},
+	});
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "osdy-pi",
+  "version": "0.1.0",
+  "description": "Osdy Pi package: themes, header, and custom editor for Pi.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "theme",
+    "extension"
+  ],
+  "files": [
+    "README.md",
+    "LICENSE",
+    "themes",
+    "extensions"
+  ],
+  "pi": {
+    "themes": [
+      "./themes/osdy-pi-dark.json",
+      "./themes/osdy-pi-light.json"
+    ],
+    "extensions": [
+      "./extensions/osdy-pi.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  }
+}

package/themes/osdy-pi-dark.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "osdy-pi-dark",
+  "vars": {
+    "void": "#080611",
+    "surface": "#151022",
+    "surface2": "#211433",
+    "pink": "#FF4FD8",
+    "hotPink": "#FF2EA6",
+    "purple": "#9B5CFF",
+    "violet": "#C084FC",
+    "cyan": "#38D5FF",
+    "textSoft": "#F8F4FF",
+    "lavenderGray": "#B9A7D8",
+    "dimPurple": "#76628F",
+    "mint": "#2FE6A6",
+    "gold": "#F5C542",
+    "coral": "#FF6B8B"
+  },
+  "colors": {
+    "accent": "pink",
+    "border": "purple",
+    "borderAccent": "hotPink",
+    "borderMuted": "#3A2852",
+    "success": "mint",
+    "error": "coral",
+    "warning": "purple",
+    "muted": "lavenderGray",
+    "dim": "dimPurple",
+    "text": "textSoft",
+    "thinkingText": "lavenderGray",
+    "selectedBg": "surface2",
+    "userMessageBg": "surface",
+    "userMessageText": "textSoft",
+    "customMessageBg": "#1C1230",
+    "customMessageText": "textSoft",
+    "customMessageLabel": "pink",
+    "toolPendingBg": "#17112B",
+    "toolSuccessBg": "#10261F",
+    "toolErrorBg": "#351326",
+    "toolTitle": "pink",
+    "toolOutput": "textSoft",
+    "mdHeading": "violet",
+    "mdLink": "cyan",
+    "mdLinkUrl": "lavenderGray",
+    "mdCode": "violet",
+    "mdCodeBlock": "textSoft",
+    "mdCodeBlockBorder": "purple",
+    "mdQuote": "lavenderGray",
+    "mdQuoteBorder": "purple",
+    "mdHr": "#3A2852",
+    "mdListBullet": "pink",
+    "toolDiffAdded": "mint",
+    "toolDiffRemoved": "coral",
+    "toolDiffContext": "lavenderGray",
+    "syntaxComment": "dimPurple",
+    "syntaxKeyword": "pink",
+    "syntaxFunction": "cyan",
+    "syntaxVariable": "textSoft",
+    "syntaxString": "mint",
+    "syntaxNumber": "violet",
+    "syntaxType": "violet",
+    "syntaxOperator": "hotPink",
+    "syntaxPunctuation": "lavenderGray",
+    "thinkingOff": "#3A2852",
+    "thinkingMinimal": "lavenderGray",
+    "thinkingLow": "purple",
+    "thinkingMedium": "pink",
+    "thinkingHigh": "violet",
+    "thinkingXhigh": "coral",
+    "bashMode": "purple"
+  },
+  "export": {
+    "pageBg": "void",
+    "cardBg": "surface",
+    "infoBg": "surface2"
+  }
+}

package/themes/osdy-pi-light.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi-mono/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "osdy-pi-light",
+  "vars": {
+    "page": "#FFF7FD",
+    "surface": "#F6EAFE",
+    "surface2": "#EBD8FF",
+    "ink": "#1B102A",
+    "pink": "#C2188F",
+    "hotPink": "#E91E9D",
+    "purple": "#6D28D9",
+    "violet": "#8B5CF6",
+    "cyan": "#007EA7",
+    "lavenderGray": "#645170",
+    "dimPurple": "#9B86AA",
+    "mint": "#0F8F68",
+    "gold": "#9E7414",
+    "coral": "#D63D68"
+  },
+  "colors": {
+    "accent": "pink",
+    "border": "purple",
+    "borderAccent": "hotPink",
+    "borderMuted": "dimPurple",
+    "success": "mint",
+    "error": "coral",
+    "warning": "purple",
+    "muted": "lavenderGray",
+    "dim": "dimPurple",
+    "text": "ink",
+    "thinkingText": "lavenderGray",
+    "selectedBg": "surface2",
+    "userMessageBg": "surface",
+    "userMessageText": "ink",
+    "customMessageBg": "surface",
+    "customMessageText": "ink",
+    "customMessageLabel": "pink",
+    "toolPendingBg": "#F2E7FF",
+    "toolSuccessBg": "#DDF7ED",
+    "toolErrorBg": "#FFE3EF",
+    "toolTitle": "pink",
+    "toolOutput": "ink",
+    "mdHeading": "violet",
+    "mdLink": "purple",
+    "mdLinkUrl": "lavenderGray",
+    "mdCode": "violet",
+    "mdCodeBlock": "ink",
+    "mdCodeBlockBorder": "purple",
+    "mdQuote": "lavenderGray",
+    "mdQuoteBorder": "purple",
+    "mdHr": "dimPurple",
+    "mdListBullet": "pink",
+    "toolDiffAdded": "mint",
+    "toolDiffRemoved": "coral",
+    "toolDiffContext": "lavenderGray",
+    "syntaxComment": "#806D91",
+    "syntaxKeyword": "pink",
+    "syntaxFunction": "purple",
+    "syntaxVariable": "ink",
+    "syntaxString": "mint",
+    "syntaxNumber": "violet",
+    "syntaxType": "violet",
+    "syntaxOperator": "hotPink",
+    "syntaxPunctuation": "lavenderGray",
+    "thinkingOff": "dimPurple",
+    "thinkingMinimal": "lavenderGray",
+    "thinkingLow": "purple",
+    "thinkingMedium": "pink",
+    "thinkingHigh": "violet",
+    "thinkingXhigh": "coral",
+    "bashMode": "purple"
+  },
+  "export": {
+    "pageBg": "page",
+    "cardBg": "#FFFFFF",
+    "infoBg": "surface"
+  }
+}