pi-smart-sessions 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HazAT
+
+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,56 @@
+# pi-smart-sessions
+
+A [Pi](https://github.com/badlogic/pi) extension that automatically names your sessions with AI-generated summaries. No more scrolling through a wall of skill tags in your session list.
+
+## Before
+
+Every skill session looks the same — impossible to tell them apart:
+
+![Before — all sessions show raw skill tags](assets/before.png)
+
+## After
+
+Each session gets a short, meaningful name:
+
+![After — sessions have AI-generated summaries](assets/after.png)
+
+The name is a skill prefix plus a 5–10 word summary of your prompt:
+
+![Session name close-up](assets/session-name.png)
+
+## How it works
+
+1. Detects when you start a session with `/skill:name your prompt here`
+2. Immediately sets a temporary name with the first 60 characters
+3. Calls a cheap model (Codex mini → Haiku → current model) to summarize your prompt in 5–10 words
+4. Updates the session name with the AI summary, prefixed by the skill name
+
+The summarization happens in the background — no delay to your workflow. If the model call fails, the truncated name is kept as a fallback.
+
+## Install
+
+```bash
+pi install npm:pi-smart-sessions
+```
+
+Or try it without installing:
+
+```bash
+pi -e npm:pi-smart-sessions
+```
+
+You can also install from git:
+
+```bash
+pi install git:github.com/HazAT/pi-smart-sessions
+```
+
+## Tips
+
+- **Existing sessions** can be renamed manually with **Ctrl+R** in the session selector
+- The extension only names the first skill-based prompt per session — it won't overwrite names you set yourself
+- Works with any skill, not just brainstorm
+
+## License
+
+MIT

package/extensions/smart-sessions.ts

@@ -0,0 +1,88 @@
+import { complete, type Model, type Api } from "@mariozechner/pi-ai";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+const skillPattern = /^\/skill:(\S+)\s*([\s\S]*)/;
+
+const SUMMARY_PROMPT =
+  "Summarize the user's request in 5-10 words max. Output ONLY the summary, nothing else. No quotes, no punctuation at the end.";
+
+const CODEX_MODEL_ID = "gpt-5.1-codex-mini";
+const HAIKU_MODEL_ID = "claude-haiku-4-5";
+
+async function pickCheapModel(ctx: {
+  model: Model<Api> | null;
+  modelRegistry: {
+    find: (p: string, id: string) => Model<Api> | undefined;
+    getApiKey: (m: Model<Api>) => Promise<string | undefined>;
+  };
+}): Promise<{ model: Model<Api>; apiKey: string } | null> {
+  const codex = ctx.modelRegistry.find("openai-codex", CODEX_MODEL_ID);
+  if (codex) {
+    const key = await ctx.modelRegistry.getApiKey(codex);
+    if (key) return { model: codex, apiKey: key };
+  }
+  const haiku = ctx.modelRegistry.find("anthropic", HAIKU_MODEL_ID);
+  if (haiku) {
+    const key = await ctx.modelRegistry.getApiKey(haiku);
+    if (key) return { model: haiku, apiKey: key };
+  }
+  if (ctx.model) {
+    const key = await ctx.modelRegistry.getApiKey(ctx.model);
+    if (key) return { model: ctx.model, apiKey: key };
+  }
+  return null;
+}
+
+export default function (pi: ExtensionAPI) {
+  let named = false;
+
+  pi.on("session_start", () => {
+    named = !!pi.getSessionName();
+  });
+
+  pi.on("input", async (event, ctx) => {
+    if (named) return;
+
+    const match = event.text.match(skillPattern);
+    if (!match) return;
+
+    const skillName = match[1];
+    const userPrompt = match[2].trim();
+    named = true;
+
+    if (!userPrompt) {
+      pi.setSessionName(`[${skillName}]`);
+      return;
+    }
+
+    // Set a temporary name immediately so something shows up
+    pi.setSessionName(`[${skillName}] ${userPrompt.slice(0, 60)}`);
+
+    // Summarize in the background with a cheap model
+    const cheap = await pickCheapModel(ctx);
+    if (!cheap) return;
+
+    try {
+      const response = await complete(
+        cheap.model,
+        {
+          systemPrompt: SUMMARY_PROMPT,
+          messages: [{ role: "user", content: [{ type: "text", text: userPrompt }], timestamp: Date.now() }],
+        },
+        { apiKey: cheap.apiKey },
+      );
+
+      const summary = response.content
+        .filter((c): c is { type: "text"; text: string } => c.type === "text")
+        .map((c) => c.text)
+        .join("")
+        .trim();
+
+      if (summary) {
+        pi.setSessionName(`[${skillName}] ${summary}`);
+      }
+    } catch {
+      // Keep the truncated name, no big deal
+    }
+  });
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "pi-smart-sessions",
+  "version": "1.0.0",
+  "description": "Auto-names Pi sessions with AI-generated summaries — no more cryptic skill tags in your session list",
+  "keywords": ["pi-package", "pi-extension", "sessions", "skills"],
+  "license": "MIT",
+  "author": "HazAT",
+  "homepage": "https://github.com/HazAT/pi-smart-sessions#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HazAT/pi-smart-sessions"
+  },
+  "files": [
+    "extensions",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-ai": "*"
+  },
+  "pi": {
+    "extensions": ["./extensions"]
+  }
+}