osdy-pi 0.1.0 → 0.1.2

package/README.md

@@ -1,97 +1,108 @@
-# osdy-pi
+# Osdy Pi
 
-Pi package for the Osdy terminal experience.
+<img width="1857" height="847" alt="image" src="https://github.com/user-attachments/assets/84907a2b-4913-41a1-bc6e-1840490d5404" />
 
-## Features
+Theme package for [Pi](https://github.com/earendil-works/pi) with the Osdy terminal style: neon pink/purple colors, a custom ASCII header, and a framed editor experience.
 
-- `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.
+## What you get
 
-## Install
+- **Dark theme:** `osdy-pi-dark`, enabled by default when the package starts.
+- **Light theme:** `osdy-pi-light`, with the same Osdy palette adapted for light terminals.
+- **Custom header:** centered Osdy-Pi ASCII branding with responsive status metadata.
+- **Custom editor:** full-width framed input area with model, thinking, token, cost, and context status.
+- **Clean layout:** the built-in footer/working row is hidden while Osdy Pi is enabled to avoid duplicated UI.
 
-Pi packages are not uploaded to a separate Pi registry. They are shared through npm, git, or a local path.
+<img width="1280" height="433" alt="image" src="https://github.com/user-attachments/assets/20c7624d-9ad8-4494-97fb-6b6d81aaf328" />
 
-### From npm
 
-After publishing this package to npm:
+## Install in Pi
+
+Install the package directly from GitHub:
 
 ```bash
-pi install npm:osdy-pi
+pi install git:github.com/OsdyOrtiz/Osdy-Pi
 ```
 
-### From GitHub
-
-After pushing this package to a GitHub repository:
+Then start Pi normally:
 
 ```bash
-pi install git:github.com/<owner>/osdy-pi
+pi
 ```
 
-You can also pin a tag or branch:
+Osdy Pi enables the `osdy-pi-dark` theme and custom UI automatically on `session_start`.
 
-```bash
-pi install git:github.com/<owner>/osdy-pi@v0.1.0
-```
+## Choose the theme manually
 
-### Local development
+If you only want to switch themes, open Pi settings:
 
-To test this package from this repository without installing it permanently:
+```text
+/settings
+```
 
-```bash
-pi -e .
+Then select one of these theme names:
+
+```text
+osdy-pi-dark
+osdy-pi-light
 ```
 
-To install it from a local path:
+You can also set it in your Pi `settings.json`:
 
-```bash
-pi install /absolute/path/to/osdy-pi
+```json
+{
+  "theme": "osdy-pi-dark"
+}
 ```
 
-## Publishing
+Use `osdy-pi-light` instead if you prefer the light version.
 
-### npm
+## Commands
 
-```bash
-npm login
-npm pack --dry-run
-npm publish
+Osdy Pi includes a small command group:
+
+```text
+/osdy-pi enable
+/osdy-pi disable
+/osdy-pi status
 ```
 
-Then verify with:
+- `enable` applies the dark Osdy theme, custom header, custom editor, and clean layout.
+- `disable` restores Pi's built-in header, editor, footer, and working visibility, then switches back to the previous theme or `dark`.
+- `status` shows whether the Osdy Pi UI is currently enabled.
+
+## Local install
+
+If you cloned this repository and want to test it locally:
 
 ```bash
-pi install npm:osdy-pi
+pi -e .
 ```
 
-### GitHub
+To install it from a local path:
 
-Initialize the repository, commit the package, push it to GitHub, then install it with the `git:` source shown above.
+```bash
+pi install /absolute/path/to/Osdy-Pi
+```
 
-## Commands
+## Package contents
 
 ```text
-/osdy-pi enable
-/osdy-pi disable
-/osdy-pi status
+themes/osdy-pi-dark.json
+themes/osdy-pi-light.json
+extensions/osdy-pi.ts
 ```
 
-`enable` applies the `osdy-pi-dark` theme, custom header, custom editor, and hides the built-in footer/working row to avoid duplicate status UI.
+The Pi manifest is declared in `package.json` through `pi.themes` and `pi.extensions`, so Pi can discover the themes and extension after installation.
 
-`disable` restores the built-in header, editor, footer, and working visibility, then switches back to the previously captured theme or `dark`.
+## Uninstall or turn off
 
-## Package resources
+To temporarily turn off the custom UI inside Pi:
 
-The Pi manifest is declared in `package.json`:
+```text
+/osdy-pi disable
+```
 
-- themes: `themes/osdy-pi-dark.json`, `themes/osdy-pi-light.json`
-- extension: `extensions/osdy-pi.ts`
+To remove the package completely, use Pi's package management command for installed packages.
 
 ## License
 

package/extensions/osdy-pi.ts

@@ -86,11 +86,19 @@ const HEADER_WIDTH = HEADER.reduce(
 const HEADER_FALLBACK = ["OSDY - PI", "</> Compilador de ideas"];
 
 class OsdyFooter implements Component {
+	private readonly ctx: ExtensionContext;
+	private readonly footerData: any;
+	private readonly theme: { fg(name: string, text: string): string };
+
 	constructor(
-		private readonly ctx: ExtensionContext,
-		private readonly footerData: any,
-		private readonly theme: { fg(name: string, text: string): string },
-	) {}
+		ctx: ExtensionContext,
+		footerData: any,
+		theme: { fg(name: string, text: string): string },
+	) {
+		this.ctx = ctx;
+		this.footerData = footerData;
+		this.theme = theme;
+	}
 
 	render(width: number): string[] {
 		let location = formatPath(this.ctx.cwd);
@@ -500,12 +508,15 @@ function applyOsdyPi(
 	ctx.ui.setWorkingVisible(false);
 
 	class OsdyEditor extends CustomEditor {
+		private readonly tuiRef: TUI;
+
 		constructor(
-			private readonly tuiRef: TUI,
+			tuiRef: TUI,
 			theme: EditorTheme,
 			keybindings: KeybindingsManager,
 		) {
 			super(tuiRef, theme, keybindings, { paddingX: 1 });
+			this.tuiRef = tuiRef;
 		}
 		render(width: number): string[] {
 			if (width < 4 || this.isShowingAutocomplete()) return super.render(width);
@@ -564,6 +575,24 @@ function disableOsdyPi(ctx: ExtensionContext, state: OsdyState): void {
 	ctx.ui.notify("osdy-pi disabled", "info");
 }
 
+function claimOsdyVisualLayer(
+	pi: ExtensionAPI,
+	ctx: ExtensionContext,
+	state: OsdyState,
+): void {
+	if (!state.enabled) return;
+	applyOsdyPi(pi, ctx, state);
+
+	// Some packages install startup headers asynchronously. Re-apply Osdy-Pi
+	// after startup so it remains the visual owner without disabling those
+	// packages' prompts, agents, MCP tools, commands, or other behavior.
+	for (const delayMs of [300, 1000]) {
+		setTimeout(() => {
+			if (state.enabled) applyOsdyPi(pi, ctx, state);
+		}, delayMs);
+	}
+}
+
 export default function (pi: ExtensionAPI) {
 	const state: OsdyState = { enabled: true, gitLabel: "-", agentsLabel: "-" };
 	pi.on("session_start", (_event, ctx) => {
@@ -589,7 +618,7 @@ export default function (pi: ExtensionAPI) {
 			.catch(() => {
 				state.agentsLabel = "0";
 			});
-		if (state.enabled) applyOsdyPi(pi, ctx, state);
+		claimOsdyVisualLayer(pi, ctx, state);
 	});
 	pi.registerCommand("osdy-pi", {
 		description: "Manage the Osdy Pi experience: enable, disable, or status.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osdy-pi",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Osdy Pi package: themes, header, and custom editor for Pi.",
   "license": "MIT",
   "type": "module",
@@ -23,7 +23,8 @@
     ],
     "extensions": [
       "./extensions/osdy-pi.ts"
-    ]
+    ],
+    "image": "https://raw.githubusercontent.com/OsdyOrtiz/Osdy-Pi/main/mapche1.png"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",