@ramarivera/coding-buddy 0.7.1 → 0.7.3

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
     },
     "metadata": {
         "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi (requires bun: https://bun.sh/install)",
-        "version": "0.7.1"
+        "version": "0.7.3"
     },
     "plugins": [
         {
             "name": "coding-buddy",
             "source": "./",
             "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi. MCP-based terminal pet with ASCII art, stats, reactions, and personality. Requires bun runtime (https://bun.sh/install).",
-            "version": "0.7.1",
+            "version": "0.7.3",
             "author": {
                 "name": "ramarivera"
             },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name": "coding-buddy",
-    "version": "0.7.1",
+    "version": "0.7.3",
     "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi. MCP-based terminal pet with ASCII art, stats, reactions, and personality.",
     "author": {
         "name": "ramarivera"

package/adapters/omp/renderers.ts

@@ -2,104 +2,73 @@ import { RARITY_STARS } from "../../core/engine.ts";
 import { getArtFrame, HAT_ART } from "../../core/render-model.ts";
 import type { Companion, ReactionState } from "../../core/model.ts";
 import type { Achievement } from "../../core/achievements.ts";
+import { getRarityColor } from "../../server/theme.ts";
+import {
+  composeDetailsAndArt,
+  displayWidth,
+  getDetailsWidth,
+  getWidgetWidth,
+  stripAnsi,
+  WIDGET_MAX_LINES,
+  wrapReaction,
+} from "../shared/widget-layout.ts";
+
+const RESET = "\x1b[0m";
+const DIM_ITALIC = "\x1b[2;3m";
+
+export { displayWidth, WIDGET_MAX_LINES as OMP_WIDGET_MAX_LINES };
 
 function trimArt(line: string): string {
   return line.replace(/\s+$/g, "");
 }
 
-const REACTION_WIDTH = 44;
-
-function displayWidth(text: string): number {
-  let width = 0;
-  for (const character of text) {
-    width += /\p{Emoji_Presentation}/u.test(character) ? 2 : 1;
-  }
-  return width;
-}
-
-function truncateToWidth(text: string, width: number): string {
-  let result = "";
-  let currentWidth = 0;
-  for (const character of text) {
-    const characterWidth = /\p{Emoji_Presentation}/u.test(character) ? 2 : 1;
-    if (currentWidth + characterWidth > width) break;
-    result += character;
-    currentWidth += characterWidth;
+function getFullArtFrame(companion: Companion, frame: number): string[] {
+  const art = getArtFrame(companion.bones.species, companion.bones.eye, frame);
+  if (companion.bones.hat !== "none" && !stripAnsi(art[0] ?? "").trim()) {
+    art[0] = HAT_ART[companion.bones.hat];
   }
-  return result;
-}
-
-function wrapReaction(reaction: string): string[] {
-  const lines: string[] = [];
-  let current = "";
-
-  for (const word of reaction.trim().split(/\s+/)) {
-    if (!word) continue;
-    if (displayWidth(word) > REACTION_WIDTH) {
-      if (current) lines.push(current);
-      lines.push(`${truncateToWidth(word, REACTION_WIDTH - 1)}…`);
-      current = "";
-      continue;
-    }
-
-    const candidate = current ? `${current} ${word}` : word;
-    if (displayWidth(candidate) > REACTION_WIDTH) {
-      lines.push(current);
-      current = word;
-    } else {
-      current = candidate;
-    }
-  }
-
-  if (current) lines.push(current);
-  return lines;
-}
-
-function renderReactionBubble(reaction: string): string[] {
-  const lines = wrapReaction(`💬 ${reaction}`);
-  const border = `╭${"─".repeat(REACTION_WIDTH + 2)}╮`;
-  return [
-    border,
-    ...lines.map((line) => `│ ${line}${" ".repeat(Math.max(0, REACTION_WIDTH - displayWidth(line)))} │`),
-    `╰${"─".repeat(REACTION_WIDTH + 2)}╯`,
-  ];
+  return art.map(trimArt);
 }
 
-export function renderBuddyStatus(companion: Companion): string {
-  const shiny = companion.bones.shiny ? " ✨" : "";
-  const stars = RARITY_STARS[companion.bones.rarity];
-  return `${trimArt(getArtFrame(companion.bones.species, companion.bones.eye, Date.now())[0])} ${companion.name} ${stars}${shiny}`;
-}
-
-export function renderBuddyWidget(
+function renderDetails(
   companion: Companion,
-  reaction?: ReactionState | null,
-  achievements: Achievement[] = [],
+  reaction: ReactionState | null | undefined,
+  achievements: Achievement[],
+  sideWidth: number,
 ): string[] {
-  const frame = Math.floor(Date.now() / 700);
-  const art = getArtFrame(companion.bones.species, companion.bones.eye, frame).map(trimArt);
-  const hat = companion.bones.hat === "none" ? [] : [trimArt(HAT_ART[companion.bones.hat])];
+  const color = getRarityColor(companion.bones.rarity);
   const stars = RARITY_STARS[companion.bones.rarity];
   const shiny = companion.bones.shiny ? " ✨" : "";
   const lines = [
-    `buddy · ${companion.name}`,
-    `${companion.bones.rarity} ${companion.bones.species} ${stars}${shiny}`,
-    "",
-    ...hat,
-    ...art,
+    `${color}${companion.name} ${stars}${shiny}${RESET}`,
+    `${companion.bones.rarity} ${companion.bones.species}`,
   ];
 
   if (reaction?.reaction) {
-    lines.push("", ...renderReactionBubble(reaction.reaction));
+    const remainingLines = Math.max(1, WIDGET_MAX_LINES - lines.length);
+    lines.push(...wrapReaction(reaction.reaction, sideWidth, remainingLines).map((line) => `${DIM_ITALIC}${line}${RESET}`));
   }
 
-  if (achievements.length > 0) {
-    lines.push("", ...achievements.map((achievement) => `🏆 ${achievement.name}`));
+  for (const achievement of achievements) {
+    if (lines.length >= WIDGET_MAX_LINES) break;
+    lines.push(`🏆 ${achievement.name}`);
   }
 
   return lines;
 }
 
+export function renderBuddyWidget(
+  companion: Companion,
+  reaction?: ReactionState | null,
+  achievements: Achievement[] = [],
+  width: number = getWidgetWidth(),
+): string[] {
+  const art = getFullArtFrame(companion, Math.floor(Date.now() / 700));
+  const sideWidth = getDetailsWidth(art, width);
+  const details = renderDetails(companion, reaction, achievements, sideWidth);
+  return composeDetailsAndArt(details, art, width, WIDGET_MAX_LINES);
+}
+
 export function renderBuddyStats(companion: Companion): string[] {
   return [
     `name: ${companion.name}`,

package/adapters/omp/ui.ts

@@ -1,7 +1,7 @@
 import type { OmpBuddyUiContext } from "./context.ts";
 import type { Achievement } from "../../core/achievements.ts";
 import type { Companion, ReactionState } from "../../core/model.ts";
-import { renderAchievementsSummary, renderBuddyStatus, renderBuddyWidget } from "./renderers.ts";
+import { renderAchievementsSummary, renderBuddyWidget } from "./renderers.ts";
 import { OmpBuddyStorage } from "./storage.ts";
 
 export class OmpBuddyUI {
@@ -27,8 +27,7 @@ export class OmpBuddyUI {
   ): void {
     const currentReaction = reaction ?? null;
     const muted = this.storage.isMuted();
-    const status = renderBuddyStatus(companion);
-    ctx.ui.setStatus("buddy", muted ? `${status} [muted]` : status);
+    ctx.ui.setStatus("buddy", undefined);
     ctx.ui.setWidget(
       "buddy",
       renderBuddyWidget(companion, muted ? null : currentReaction, achievements),

package/adapters/pi/renderers.ts

@@ -2,45 +2,59 @@ import { RARITY_STARS } from "../../core/engine.ts";
 import { getArtFrame, HAT_ART } from "../../core/render-model.ts";
 import type { Companion, ReactionState } from "../../core/model.ts";
 import type { Achievement } from "../../core/achievements.ts";
+import { getRarityColor } from "../../server/theme.ts";
+import {
+  composeDetailsAndArt,
+  getDetailsWidth,
+  getWidgetWidth,
+  WIDGET_MAX_LINES,
+  wrapReaction,
+} from "../shared/widget-layout.ts";
+
+export const PI_WIDGET_MAX_LINES = WIDGET_MAX_LINES;
+
+const RESET = "\x1b[0m";
+const DIM_ITALIC = "\x1b[2;3m";
 
 function trimArt(line: string): string {
   return line.replace(/\s+$/g, "");
 }
 
-export function renderBuddyStatus(companion: Companion, reaction?: ReactionState | null): string {
-  const shiny = companion.bones.shiny ? " ✨" : "";
-  const stars = RARITY_STARS[companion.bones.rarity];
-  const suffix = reaction?.reaction ? ` — ${reaction.reaction}` : "";
-  return `${trimArt(getArtFrame(companion.bones.species, companion.bones.eye, Date.now())[0])} ${companion.name} ${stars}${shiny}${suffix}`;
-}
-
 export function renderBuddyWidget(
   companion: Companion,
   reaction?: ReactionState | null,
   achievements: Achievement[] = [],
+  width: number = getWidgetWidth(),
 ): string[] {
-  const frame = Math.floor(Date.now() / 700);
-  const art = getArtFrame(companion.bones.species, companion.bones.eye, frame).map(trimArt);
-  const hat = companion.bones.hat === "none" ? [] : [trimArt(HAT_ART[companion.bones.hat])];
+  const art = getFullArtFrame(companion, Math.floor(Date.now() / 700));
+  const sideWidth = getDetailsWidth(art, width);
+  const color = getRarityColor(companion.bones.rarity);
   const stars = RARITY_STARS[companion.bones.rarity];
   const shiny = companion.bones.shiny ? " ✨" : "";
-  const lines = [
-    `buddy · ${companion.name}`,
-    `${companion.bones.rarity} ${companion.bones.species} ${stars}${shiny}`,
-    "",
-    ...hat,
-    ...art,
+  const details = [
+    `${color}${companion.name} ${stars}${shiny}${RESET}`,
+    `${companion.bones.rarity} ${companion.bones.species}`,
   ];
 
   if (reaction?.reaction) {
-    lines.push("", `“${reaction.reaction}”`);
+    const remainingLines = Math.max(1, PI_WIDGET_MAX_LINES - details.length);
+    details.push(...wrapReaction(reaction.reaction, sideWidth, remainingLines).map((line) => `${DIM_ITALIC}${line}${RESET}`));
   }
 
-  if (achievements.length > 0) {
-    lines.push("", ...achievements.map((achievement) => `🏆 ${achievement.name}`));
+  for (const achievement of achievements) {
+    if (details.length >= PI_WIDGET_MAX_LINES) break;
+    details.push(`🏆 ${achievement.name}`);
   }
 
-  return lines;
+  return composeDetailsAndArt(details, art, width, PI_WIDGET_MAX_LINES);
+}
+
+function getFullArtFrame(companion: Companion, frame: number): string[] {
+  const art = getArtFrame(companion.bones.species, companion.bones.eye, frame);
+  if (companion.bones.hat !== "none" && !(art[0] ?? "").trim()) {
+    art[0] = HAT_ART[companion.bones.hat];
+  }
+  return art.map(trimArt);
 }
 
 export function renderBuddyStats(companion: Companion): string[] {

package/adapters/pi/ui.ts

@@ -1,7 +1,7 @@
 import type { ExtensionContext } from "@mariozechner/pi-coding-agent";
 import type { Achievement } from "../../core/achievements.ts";
 import type { Companion, ReactionState } from "../../core/model.ts";
-import { renderAchievementsSummary, renderBuddyStatus, renderBuddyWidget } from "./renderers.ts";
+import { renderAchievementsSummary, renderBuddyWidget } from "./renderers.ts";
 import { PiBuddyStorage } from "./storage.ts";
 
 type PiBuddyUiContext = ExtensionContext & {
@@ -32,8 +32,7 @@ export class PiBuddyUI {
   ): void {
     const currentReaction = reaction ?? null;
     const muted = this.storage.isMuted();
-    const status = renderBuddyStatus(companion, muted ? null : currentReaction);
-    ctx.ui.setStatus("buddy", muted ? `${status} [muted]` : status);
+    ctx.ui.setStatus("buddy", undefined);
     ctx.ui.setWidget(
       "buddy",
       renderBuddyWidget(companion, muted ? null : currentReaction, achievements),

package/adapters/shared/widget-layout.ts

@@ -0,0 +1,96 @@
+const ANSI_PATTERN = /\x1b\[[0-?]*[ -/]*[@-~]/g;
+const ART_GAP = "  ";
+const DEFAULT_WIDGET_WIDTH = 78;
+
+export const WIDGET_MAX_LINES = 10;
+
+export function stripAnsi(text: string): string {
+  return text.replace(ANSI_PATTERN, "");
+}
+
+function characterWidth(character: string, next?: string): number {
+  if (character === "\u200d" || /[\uFE00-\uFE0F]/u.test(character)) return 0;
+  if (next === "\uFE0F" && /\p{Emoji}/u.test(character)) return 2;
+  return /\p{Emoji_Presentation}/u.test(character) ? 2 : 1;
+}
+
+export function displayWidth(text: string): number {
+  const characters = [...stripAnsi(text)];
+  let width = 0;
+  for (let index = 0; index < characters.length; index += 1) {
+    width += characterWidth(characters[index]!, characters[index + 1]);
+  }
+  return width;
+}
+
+export function truncateToWidth(text: string, width: number): string {
+  if (width <= 0) return "";
+  let result = "";
+  let currentWidth = 0;
+  for (const character of [...stripAnsi(text)]) {
+    const nextWidth = characterWidth(character);
+    if (currentWidth + nextWidth > width) break;
+    result += character;
+    currentWidth += nextWidth;
+  }
+  return result;
+}
+
+export function wrapReaction(reaction: string, width: number, maxLines: number): string[] {
+  const lines: string[] = [];
+  let current = "";
+
+  for (const word of `💬 ${reaction.trim()}`.split(/\s+/)) {
+    if (!word) continue;
+    if (displayWidth(word) > width) {
+      if (current) lines.push(current);
+      lines.push(`${truncateToWidth(word, Math.max(1, width - 1))}…`);
+      current = "";
+      continue;
+    }
+
+    const candidate = current ? `${current} ${word}` : word;
+    if (displayWidth(candidate) > width) {
+      if (current) lines.push(current);
+      current = word;
+    } else {
+      current = candidate;
+    }
+  }
+
+  if (current) lines.push(current);
+  if (lines.length <= maxLines) return lines;
+
+  const bounded = lines.slice(0, maxLines);
+  const last = bounded[maxLines - 1] ?? "";
+  bounded[maxLines - 1] = `${truncateToWidth(last, Math.max(1, width - 1))}…`;
+  return bounded;
+}
+
+export function getWidgetWidth(): number {
+  const columns = process.stdout.columns;
+  return columns && columns > 0 ? Math.max(24, columns - 2) : DEFAULT_WIDGET_WIDTH;
+}
+
+export function getDetailsWidth(art: string[], width: number = getWidgetWidth()): number {
+  const artWidth = Math.max(...art.map(displayWidth), 0);
+  return Math.max(8, Math.max(24, width) - artWidth - ART_GAP.length);
+}
+
+export function composeDetailsAndArt(
+  details: string[],
+  art: string[],
+  width: number = getWidgetWidth(),
+  maxLines: number = WIDGET_MAX_LINES,
+): string[] {
+  const artWidth = Math.max(...art.map(displayWidth), 0);
+  const sideWidth = getDetailsWidth(art, width);
+  const rows = Math.max(art.length, details.length);
+
+  return Array.from({ length: Math.min(maxLines, rows) }, (_, index) => {
+    const artLine = art[index] ?? "";
+    const detailLine = details[index] ?? "";
+    const boundedDetailLine = displayWidth(detailLine) > sideWidth ? truncateToWidth(detailLine, sideWidth) : detailLine;
+    return `${boundedDetailLine}${" ".repeat(Math.max(0, sideWidth - displayWidth(boundedDetailLine)))}${ART_GAP}${artLine}${" ".repeat(Math.max(0, artWidth - displayWidth(artLine)))}`;
+  });
+}

package/cli/install.ts

@@ -8,12 +8,13 @@
  */
 
 import { readFileSync, writeFileSync, mkdirSync, existsSync, cpSync } from "fs";
-import { execSync } from "child_process";
+import { execFileSync, execSync } from "child_process";
 import { resolve, dirname, join } from "path";
 
 import { generateBones, renderBuddy, renderFace, RARITY_STARS } from "../core/engine.ts"
 import {
   claudeConfigDir,
+  buddyStateDir,
   claudeSettingsPath,
   claudeSkillDir,
   claudeUserConfigPath,
@@ -21,6 +22,7 @@ import {
 } from "../server/path.ts";
 import { loadCompanion, saveCompanion, resolveUserId, writeStatusState } from "../server/state.ts";
 import { generateFallbackName } from "../core/reactions.ts"
+import { copyRuntimeApp, stableRuntimePaths } from "./runtime-app.ts";
 
 const CYAN = "\x1b[36m";
 const GREEN = "\x1b[32m";
@@ -116,8 +118,8 @@ function saveSettings(settings: Record<string, any>) {
 
 // ─── Step 1: Register MCP server (in ~/.claude.json) ────────────────────────
 
-function installMcp() {
-  const serverPath = join(PROJECT_ROOT, "server", "index.ts");
+function installMcp(appDir: string) {
+  const serverPath = stableRuntimePaths(appDir).mcpServer;
 
   let claudeJson: Record<string, any> = {};
   try {
@@ -129,7 +131,7 @@ function installMcp() {
   claudeJson.mcpServers["claude-buddy"] = {
     command: "bun",
     args: [toUnixPath(serverPath)],
-    cwd: toUnixPath(PROJECT_ROOT),
+    cwd: toUnixPath(appDir),
   };
 
   writeFileSync(CLAUDE_JSON_PATH, JSON.stringify(claudeJson, null, 2));
@@ -147,8 +149,8 @@ function installSkill() {
 
 // ─── Step 3: Configure status line (with animation refresh) ─────────────────
 
-function installStatusLine(settings: Record<string, any>) {
-  const statusScript = join(PROJECT_ROOT, "statusline", "buddy-status.sh");
+function installStatusLine(settings: Record<string, any>, appDir: string) {
+  const statusScript = stableRuntimePaths(appDir).statusline;
 
   settings.statusLine = {
     type: "command",
@@ -181,13 +183,14 @@ function stripLegacyPopupHooks(settings: Record<string, any>) {
 
 // ─── Step 4: Register hooks ─────────────────────────────────────────────────
 
-function installHooks(settings: Record<string, any>) {
-  const reactHook     = join(PROJECT_ROOT, "hooks", "react.sh");
-  const fileTypeHook  = join(PROJECT_ROOT, "hooks", "file-type-react.sh");
-  const commentHook   = join(PROJECT_ROOT, "hooks", "buddy-comment.sh");
-  const suggestHook   = join(PROJECT_ROOT, "hooks", "suggest.sh");
-  const nameHook      = join(PROJECT_ROOT, "hooks", "name-react.sh");
-  const moodHook      = join(PROJECT_ROOT, "hooks", "mood-react.sh");
+function installHooks(settings: Record<string, any>, appDir: string) {
+  const hooksDir = stableRuntimePaths(appDir).hooks;
+  const reactHook     = join(hooksDir, "react.sh");
+  const fileTypeHook  = join(hooksDir, "file-type-react.sh");
+  const commentHook   = join(hooksDir, "buddy-comment.sh");
+  const suggestHook   = join(hooksDir, "suggest.sh");
+  const nameHook      = join(hooksDir, "name-react.sh");
+  const moodHook      = join(hooksDir, "mood-react.sh");
   const commandHook = (command: string) => ({
     type: "command",
     command: toUnixPath(command),
@@ -239,6 +242,15 @@ function installHooks(settings: Record<string, any>) {
   ok("Hooks registered: PostToolUse (Bash + Write/Edit) + Stop (comment + suggest) + UserPromptSubmit (name + mood)");
 }
 
+function installRuntimeApp(): string {
+  const appDir = copyRuntimeApp(PROJECT_ROOT, buddyStateDir());
+  const installArgs = ["install", "--production", "--ignore-scripts"];
+  if (existsSync(join(appDir, "bun.lock"))) installArgs.push("--frozen-lockfile");
+  execFileSync("bun", installArgs, { cwd: appDir, stdio: "ignore" });
+  ok(`Stable runtime installed: ${appDir}`);
+  return appDir;
+}
+
 // ─── Step 5: Ensure MCP tools are allowed ───────────────────────────────────
 
 function ensurePermissions(settings: Record<string, any>) {
@@ -301,14 +313,15 @@ console.log("");
 info("Installing coding-buddy...\n");
 
 const settings = loadSettings();
+const appDir = installRuntimeApp();
 
-installMcp();
+installMcp(appDir);
 installSkill();
 
 stripLegacyPopupHooks(settings);
-installStatusLine(settings);
+installStatusLine(settings, appDir);
 
-installHooks(settings);
+installHooks(settings, appDir);
 ensurePermissions(settings);
 saveSettings(settings);
 

package/cli/runtime-app.ts

@@ -0,0 +1,49 @@
+import { cpSync, existsSync, mkdirSync, rmSync } from "fs";
+import { join } from "path";
+
+export const RUNTIME_DIRECTORIES = [
+  "core",
+  "server",
+  "hooks",
+  "statusline",
+  "scripts",
+] as const;
+
+export const RUNTIME_FILES = ["package.json", "bun.lock"] as const;
+
+export function stableRuntimeAppDir(stateDir: string): string {
+  return join(stateDir, "app");
+}
+
+export function stableRuntimePaths(appDir: string) {
+  return {
+    mcpServer: join(appDir, "server", "index.ts"),
+    mcpLauncher: join(appDir, "server", "mcp-launcher.sh"),
+    statusline: join(appDir, "statusline", "buddy-status.sh"),
+    combinedStatusline: join(appDir, "statusline", "combined-status.sh"),
+    hooks: join(appDir, "hooks"),
+  };
+}
+
+/**
+ * Replace the stable runtime copy. The app directory is owned by the
+ * installer, so removing it first also removes files deleted by an upgrade.
+ */
+export function copyRuntimeApp(sourceRoot: string, stateDir: string): string {
+  const appDir = stableRuntimeAppDir(stateDir);
+  rmSync(appDir, { recursive: true, force: true });
+  mkdirSync(appDir, { recursive: true });
+
+  for (const directory of RUNTIME_DIRECTORIES) {
+    const source = join(sourceRoot, directory);
+    if (!existsSync(source)) throw new Error(`Missing runtime directory: ${source}`);
+    cpSync(source, join(appDir, directory), { recursive: true, force: true });
+  }
+
+  for (const file of RUNTIME_FILES) {
+    const source = join(sourceRoot, file);
+    if (existsSync(source)) cpSync(source, join(appDir, file), { force: true });
+  }
+
+  return appDir;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramarivera/coding-buddy",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi",
   "type": "module",
   "omp": {

package/server/index.ts

@@ -9,6 +9,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { existsSync } from "fs";
 import { join, resolve, dirname } from "path";
 
 import { generateBones,
@@ -45,6 +46,7 @@ import {
 } from "./state";
 import {
   buddyStateDir,
+  buddyAppDir,
   claudeConfigDir,
   claudeSettingsPath,
 } from "./path";
@@ -622,7 +624,7 @@ server.tool("buddy_unmute", "Unmute buddy reactions", {}, async () => {
 
 server.tool(
   "buddy_statusline",
-  "Enable or disable the buddy status line, and toggle combined mode (shows rate-limit usage bars alongside the buddy). Returns current status if called without arguments.",
+  "Enable or disable the buddy status line, toggle combined mode (shows rate-limit usage bars alongside the buddy), or set a cached asynchronous sub-status command. Returns current status if called without arguments.",
   {
     enabled: z
       .boolean()
@@ -636,17 +638,24 @@ server.tool(
       .describe(
         "true to show rate-limit usage bars alongside buddy (requires python3), false for buddy-only mode.",
       ),
+    subStatusCommand: z
+      .string()
+      .optional()
+      .describe(
+        "Shell command whose cached output is appended below the buddy panel. Empty string clears it; the command always runs asynchronously.",
+      ),
   },
-  async ({ enabled, combined }) => {
-    if (enabled === undefined && combined === undefined) {
+  async ({ enabled, combined, subStatusCommand }) => {
+    if (enabled === undefined && combined === undefined && subStatusCommand === undefined) {
       const cfg = loadConfig();
       const state = cfg.statusLineEnabled ? "enabled" : "disabled";
       const mode = cfg.useCombinedStatus ? "combined (with rate-limit bars)" : "basic (buddy only)";
+      const subStatus = cfg.subStatusCommand ?? "unset";
       return {
         content: [
           {
             type: "text",
-            text: `Status line: ${state}\nMode: ${mode}\nUse /buddy statusline on|off to toggle, /buddy statusline combined to add rate-limit bars.\nRestart Claude Code after changes for them to take effect.`,
+            text: `Status line: ${state}\nMode: ${mode}\nSub-status command: ${subStatus}\nUse /buddy statusline on|off to toggle, /buddy statusline combined to add rate-limit bars, or set subStatusCommand to append cached command output.\nRestart Claude Code after changes for them to take effect.`,
           },
         ],
       };
@@ -656,6 +665,10 @@ server.tool(
       saveConfig({ useCombinedStatus: combined });
     }
 
+    if (subStatusCommand !== undefined) {
+      saveConfig({ subStatusCommand: subStatusCommand.trim() ? subStatusCommand : undefined });
+    }
+
     if (enabled !== undefined) {
       saveConfig({ statusLineEnabled: enabled });
     }
@@ -663,7 +676,10 @@ server.tool(
     const cfg = loadConfig();
 
     if (cfg.statusLineEnabled) {
-      const pluginRoot = resolve(dirname(import.meta.dir));
+      const installedRoot = buddyAppDir();
+      const pluginRoot = existsSync(join(installedRoot, "statusline", "buddy-status.sh"))
+        ? installedRoot
+        : resolve(dirname(import.meta.dir));
       const scriptName = cfg.useCombinedStatus ? "combined-status.sh" : "buddy-status.sh";
       const statusScript = join(pluginRoot, "statusline", scriptName);
       setBuddyStatusLine(statusScript);

package/server/path.ts

@@ -80,3 +80,8 @@ export function buddyStateDir(): string {
   if (cfgDir) return join(cfgDir, "buddy-state");
   return join(homedir(), ".claude-buddy");
 }
+
+/** Stable per-profile runtime copy used by installer registrations. */
+export function buddyAppDir(): string {
+  return join(buddyStateDir(), "app");
+}

package/server/state.ts

@@ -324,6 +324,7 @@ export interface BuddyConfig {
   bubbleWidth: number;
   bubbleMargin: number;
   useCombinedStatus: boolean;
+  subStatusCommand?: string;
   rainbowColors?: string[];
   theme: "dark" | "light" | "auto";
   moodEnabled: boolean;
@@ -349,12 +350,22 @@ const DEFAULT_CONFIG: BuddyConfig = {
   suggestionCooldown: 180,
 };
 
+export function normalizeConfig(data: unknown): BuddyConfig {
+  const values = data && typeof data === "object" && !Array.isArray(data)
+    ? data
+    : {};
+  const config = { ...DEFAULT_CONFIG, ...values } as BuddyConfig;
+  if (typeof config.subStatusCommand !== "string" || config.subStatusCommand.trim() === "") {
+    delete config.subStatusCommand;
+  }
+  return config;
+}
+
 export function loadConfig(): BuddyConfig {
   try {
-    const data = JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
-    return { ...DEFAULT_CONFIG, ...data };
+    return normalizeConfig(JSON.parse(readFileSync(CONFIG_FILE, "utf8")));
   } catch {
-    return { ...DEFAULT_CONFIG };
+    return normalizeConfig({});
   }
 }
 
@@ -507,6 +518,7 @@ const TRANSIENT_PREFIXES = [
   "reaction.",
   ".last_reaction.",
   ".last_comment.",
+  ".substatus.",
 ];
 
 /**

package/statusline/buddy-status.sh

@@ -16,6 +16,7 @@
 
 # shellcheck source=../scripts/paths.sh
 source "$(dirname "${BASH_SOURCE[0]}")/../scripts/paths.sh"
+source "$(dirname "${BASH_SOURCE[0]}")/substatus.sh"
 
 STATE="$BUDDY_STATE_DIR/status.json"
 CONFIG_FILE="$BUDDY_STATE_DIR/config.json"
@@ -39,7 +40,7 @@ ACHIEVEMENT=$(jq -r '.achievement // ""' "$STATE" 2>/dev/null)
 LEVEL=$(jq -r '.level // 1' "$STATE" 2>/dev/null)
 MOOD=$(jq -r '.mood // "focused"' "$STATE" 2>/dev/null)
 
-cat > /dev/null  # drain stdin
+BUDDY_STATUSLINE_INPUT=$(cat)
 
 # ─── Animation: pick current frame from server-rendered frames ──────────────
 NOW=${BUDDY_FAKE_NOW:-$(date +%s)}
@@ -402,4 +403,8 @@ for (( i=0; i<MAX_LINES; i++ )); do
     fi
 done
 
+# Append the last cached sub-status result below the buddy panel and refresh
+# it asynchronously when stale. The statusline itself never waits on it.
+append_substatus
+
 exit 0

package/statusline/combined-status.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # statusline/combined-status.sh
 # Two-panel status line: rate-limit stats left, buddy art right.
-# buddy-status.sh is intentionally untouched (kept clean for upstream PR).
+# buddy-status.sh renders the buddy panel and shared cached sub-status below it.
 
 [ "$BUDDY_SHELL" = "1" ] && exit 0
 
@@ -54,7 +54,7 @@ except Exception:
 " 2>/dev/null)
 
 # ── Capture buddy art (buddy reads state files, not stdin) ───────────────────
-BUDDY_OUTPUT=$("$BUDDY_SCRIPT" </dev/null 2>/dev/null)
+BUDDY_OUTPUT=$(printf '%s' "$STDIN_DATA" | "$BUDDY_SCRIPT" 2>/dev/null)
 
 # No buddy output → exit silently (muted, no state, etc.)
 [ -z "$BUDDY_OUTPUT" ] && exit 0

package/statusline/substatus.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Shared cached sub-status renderer for the buddy statusline scripts.
+#
+# The command is intentionally launched from a detached process. Claude Code
+# kills a statusline process when the next one starts, so running the command
+# inline would make slow commands disappear before they can finish.
+
+_substatus_mtime() {
+    local path="$1"
+    local value
+    value=$(stat -f %m "$path" 2>/dev/null)
+    case "$value" in
+        ''|*[!0-9]*) value=$(stat -c %Y "$path" 2>/dev/null) ;;
+    esac
+    case "$value" in
+        ''|*[!0-9]*) echo 0 ;;
+        *) echo "$value" ;;
+    esac
+}
+
+append_substatus() {
+    local state_dir="$BUDDY_STATE_DIR"
+    local sid="${BUDDY_SID:-default}"
+    local config_file="$state_dir/config.json"
+    local cache_file="$state_dir/.substatus.$sid"
+    local lock_dir="$state_dir/.substatus.$sid.lock"
+    local command=""
+    local now cache_age lock_age
+
+    [ -f "$config_file" ] || return 0
+    command=$(jq -r '.subStatusCommand // ""' "$config_file" 2>/dev/null)
+    [ -n "$command" ] || return 0
+
+    # Always show the last complete result first. A missing or stale cache is
+    # allowed to be blank; the refresh below will populate the next tick.
+    [ -f "$cache_file" ] && cat "$cache_file"
+
+    now=$(date +%s)
+    cache_age=999999
+    if [ -f "$cache_file" ]; then
+        cache_age=$(( now - $(_substatus_mtime "$cache_file") ))
+        [ "$cache_age" -lt 0 ] && cache_age=0
+    fi
+    [ "$cache_age" -lt 5 ] && return 0
+
+    # mkdir is the portable atomic lock primitive. Only remove locks that are
+    # over a minute old, so a slow but healthy command is never duplicated.
+    if [ -d "$lock_dir" ]; then
+        lock_age=$(( now - $(_substatus_mtime "$lock_dir") ))
+        if [ "$lock_age" -gt 60 ]; then
+            rmdir "$lock_dir" 2>/dev/null || rm -rf "$lock_dir" 2>/dev/null
+        fi
+    fi
+
+    mkdir "$lock_dir" 2>/dev/null || return 0
+
+    # Keep the parent statusline fast even when the command takes minutes.
+    # The explicit /dev/null stdin makes this process independent of Claude's
+    # killed statusline process; the captured payload is piped to the command.
+    (
+        local tmp_file="$cache_file.$$"
+        printf '%s' "${BUDDY_STATUSLINE_INPUT:-}" | sh -c "$command" > "$tmp_file" 2>/dev/null
+        mv "$tmp_file" "$cache_file" 2>/dev/null || rm -f "$tmp_file" 2>/dev/null
+        rmdir "$lock_dir" 2>/dev/null || rm -rf "$lock_dir" 2>/dev/null
+    ) </dev/null > /dev/null 2>/dev/null &
+}