killeros 1.0.1 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to KillerOS are documented here.
+
+## [1.2.0] - 2026-07-30
+
+### Added
+
+- A 52-column Compact startup card with inline version, polished model/provider identity, reasoning level, `/model`, working directory, and conditional Git branch.
+- A shuffled startup-tip deck that keeps one tip stable per session and exhausts the bank before repeating.
+- A responsive footer that preserves model and context while progressively removing lower-priority telemetry.
+- Packaged KillerOS theme with coral accents and one neutral tool-call surface across pending, success, and error states.
+- Single-glyph Spark activity indicator with a restrained color pulse.
+- Claude-adjacent activity word bank that advances between agent runs.
+- Static `└ Thinking…` label for hidden reasoning blocks.
+- Responsive header and footer tests across narrow terminal widths.
+
+### Changed
+
+- Replaced the animated startup illustration and capability inventory with the Compact startup card and one external tip.
+- Standardized product branding on mixed-case `KillerOS` and the neutral `› KillerOS (v1.2.0)` lockup.
+- Made theme neutrals achromatic while preserving the coral accent.
+- Replaced the footer progress bar with direct `percent left (tokens)` context telemetry and a critical `/compact` prompt.

package/Killeros.ts

@@ -1,3 +1,5 @@
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
 import os from "node:os";
 import {
   CustomEditor,
@@ -27,29 +29,52 @@ import {
 } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 
-const BRAND_RGB = "215;119;87";
-const LEFT_PANEL_WIDTH = 42;
-const LOGO_CELL = "███";
-const LOGO_ANIMATION_INTERVAL_MS = 120;
-const TIP_ROTATION_INTERVAL_MS = 5_000;
+const COMMAND_BLUE_RGB = "120;169;255";
 const FOOTER_REFRESH_INTERVAL_MS = 1_000;
+const COMPACT_HEADER_MAX_WIDTH = 52;
 
-const brand = (text: string): string => `\x1B[38;2;${BRAND_RGB}m${text}\x1B[39m`;
+const commandBlue = (text: string): string => `\x1B[38;2;${COMMAND_BLUE_RGB}m${text}\x1B[39m`;
 
-const ORCA_ART = [
-  ".....g......",
-  "....ggg.....",
-  ".gggggggg..g",
-  "gbggwwgggggg",
-  ".ggwwgggg..g",
-  "...gggg.....",
-  ".....gg.....",
+function readPackageVersion(path: string | URL): string | undefined {
+  try {
+    const value = JSON.parse(readFileSync(path, "utf8")) as { version?: unknown };
+    return typeof value.version === "string" ? value.version : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+const KILLEROS_VERSION = readPackageVersion(new URL("./package.json", import.meta.url));
+
+const STARTUP_TIPS = [
+  "Press Shift+Enter to insert a line break without sending.",
+  "Run /variants to tune the model's reasoning depth.",
+  "Type / to browse every command available in this session.",
 ] as const;
-const ORCA_WIDTH = ORCA_ART[0].length;
-const LOGO_FRAME_COUNT = ORCA_WIDTH + 3;
 
-function extractProvider(model: ExtensionContext["model"]): string {
-  return model?.provider ?? "";
+function resolveGitBranch(cwd: string): string | undefined {
+  try {
+    const branch = execFileSync("git", ["-C", cwd, "rev-parse", "--abbrev-ref", "HEAD"], {
+      encoding: "utf8",
+      maxBuffer: 64 * 1024,
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 500,
+      windowsHide: true,
+    }).trim();
+    if (!branch) return undefined;
+    return branch === "HEAD" ? "detached" : branch;
+  } catch {
+    return undefined;
+  }
+}
+
+function shuffledTips(): string[] {
+  const tips = [...STARTUP_TIPS];
+  for (let index = tips.length - 1; index > 0; index -= 1) {
+    const swapIndex = Math.floor(Math.random() * (index + 1));
+    [tips[index], tips[swapIndex]] = [tips[swapIndex]!, tips[index]!];
+  }
+  return tips;
 }
 
 function formatCwd(cwd: string): string {
@@ -64,226 +89,74 @@ function formatCwd(cwd: string): string {
     : cwd;
 }
 
-function center(text: string, width: number): string {
-  if (width <= 0) return "";
-  const textWidth = visibleWidth(text);
-  if (textWidth >= width) return truncateToWidth(text, width, "");
-  return `${" ".repeat(Math.floor((width - textWidth) / 2))}${text}`;
-}
-
 function padRight(text: string, width: number): string {
   if (width <= 0) return "";
   const clipped = truncateToWidth(text, width, "");
   return clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
 }
 
-type LogoColor = "body" | "white" | "brand" | "panel";
-
-function colorCell(color: LogoColor): string {
-  switch (color) {
-    case "body": return `\x1B[90m${LOGO_CELL}\x1B[39m`;
-    case "white": return `\x1B[97m${LOGO_CELL}\x1B[39m`;
-    case "brand": return brand(LOGO_CELL);
-    default: return " ".repeat(LOGO_CELL.length);
-  }
-}
-
-function piLogoFrame(frameIndex: number): string[] {
-  const visibleColumns = Math.min(ORCA_WIDTH, frameIndex + 1);
-  const eyeColor: LogoColor = frameIndex === ORCA_WIDTH ? "white" : "brand";
-  return ORCA_ART.map((row) => [...row].map((cell, index) => {
-    if (index >= visibleColumns) return colorCell("panel");
-    if (cell === "g") return colorCell("body");
-    if (cell === "w") return colorCell("white");
-    if (cell === "b") return colorCell(eyeColor);
-    return colorCell("panel");
-  }).join(""));
-}
-
-function borderLine(left: string, label: string, right: string, width: number): string {
-  if (width <= 0) return "";
-  if (width === 1) return brand(truncateToWidth(left, 1, ""));
-  const edgeWidth = visibleWidth(left) + visibleWidth(right);
-  if (width <= edgeWidth) return brand(truncateToWidth(left + right, width, ""));
-  const available = width - edgeWidth;
-  const clippedLabel = truncateToWidth(label, Math.max(0, available - 2), "");
-  const labelWidth = visibleWidth(clippedLabel);
-  if (labelWidth === 0 || available < labelWidth + 2) {
-    return `${brand(left)}${brand("─".repeat(available))}${brand(right)}`;
-  }
-  const fill = available - labelWidth - 2;
-  const before = Math.min(3, fill);
-  const after = fill - before;
-  return `${brand(left)}${brand("─".repeat(before))} ${clippedLabel} ${brand("─".repeat(after))}${brand(right)}`;
-}
-
-function boxedLine(content: string, width: number): string {
-  if (width <= 0) return "";
-  if (width <= 2) return truncateToWidth(content, width, "");
-  return `${brand("│")}${padRight(content, width - 2)}${brand("│")}`;
-}
-
-function twoColumn(left: string, right: string, leftWidth: number, rightWidth: number): string {
-  return `${padRight(left, leftWidth)} ${brand("│")} ${padRight(right, rightWidth)}`;
-}
-
-const TIP_SETS = [
-  [
-    "",
-    "Shortcuts & Commands",
-    "/variants  — model reasoning",
-    "/compact   — compress context",
-    "/model     — choose a model",
-    "────────────────────────",
-    "Keybindings",
-    "Shift+Enter — new line",
-    "Esc         — cancel generation",
-    "Ctrl+C      — interrupt agent",
-  ],
-  [
-    "",
-    "Session",
-    "/new      — start a session",
-    "/name     — name this session",
-    "/session  — usage and stats",
-    "────────────────────────",
-    "Workflow",
-    "Give Pi a goal and constraints",
-    "Ask it to run the relevant tests",
-    "Review changes before committing",
-  ],
-  [
-    "",
-    "Useful Commands",
-    "/copy    — copy last response",
-    "/tree    — navigate branches",
-    "/reload  — reload resources",
-    "────────────────────────",
-    "Extension locations",
-    "Global: ~/.pi/agent/extensions",
-    "Project: .pi/extensions",
-    "Reload after making changes",
-  ],
-  [
-    "",
-    "Navigation",
-    "Up/Down  — command history",
-    "Tab      — autocomplete",
-    "Ctrl+L   — clear the screen",
-    "────────────────────────",
-    "Good defaults",
-    "Keep edits scoped",
-    "Test after refactoring",
-    "Verify output before committing",
-  ],
-] as const;
-
-function getTipLines(index: number, theme: Theme): string[] {
-  const selected = TIP_SETS[index % TIP_SETS.length] ?? TIP_SETS[0];
-  return selected.map((line, lineIndex) => {
-    if (lineIndex === 1 || lineIndex === 6) return brand(theme.bold(line));
-    if (line.startsWith("─")) return brand(line);
-    if (line.startsWith("/")) {
-      const [command, ...rest] = line.split(" ");
-      return `${theme.fg("accent", command ?? "")}${theme.fg("dim", ` ${rest.join(" ")}`)}`;
-    }
-    return theme.fg(lineIndex > 6 ? "muted" : "dim", line);
-  });
+function compactBoxLine(content: string, width: number, theme: Theme): string {
+  if (width < 4) return truncateToWidth(content, width, "");
+  return `${theme.fg("dim", "│")} ${padRight(content, width - 4)} ${theme.fg("dim", "│")}`;
 }
 
 class PiStartupHeader {
   private readonly pi: ExtensionAPI;
   private readonly ctx: ExtensionContext;
-  private readonly tui: TUI;
-  private frame = 0;
-  private tipIndex = 0;
-  private animationTimer?: ReturnType<typeof setInterval>;
-  private tipTimer?: ReturnType<typeof setInterval>;
-  private disposed = false;
-
-  constructor(
-    pi: ExtensionAPI,
-    ctx: ExtensionContext,
-    tui: TUI,
-  ) {
+  private readonly branch: string | undefined;
+  private readonly tip: string;
+
+  constructor(pi: ExtensionAPI, ctx: ExtensionContext, tip: string) {
     this.pi = pi;
     this.ctx = ctx;
-    this.tui = tui;
-    this.animationTimer = setInterval(() => {
-      if (this.disposed) return;
-      if (this.frame >= LOGO_FRAME_COUNT - 1) {
-        this.stopAnimation();
-        return;
-      }
-      this.frame += 1;
-      this.tui.requestRender();
-      if (this.frame >= LOGO_FRAME_COUNT - 1) this.stopAnimation();
-    }, LOGO_ANIMATION_INTERVAL_MS);
-    this.animationTimer.unref?.();
-
-    this.tipTimer = setInterval(() => {
-      if (this.disposed) return;
-      this.tipIndex = (this.tipIndex + 1) % TIP_SETS.length;
-      this.tui.requestRender();
-    }, TIP_ROTATION_INTERVAL_MS);
-    this.tipTimer.unref?.();
+    this.branch = resolveGitBranch(ctx.cwd);
+    this.tip = tip;
   }
 
-  private stopAnimation(): void {
-    if (!this.animationTimer) return;
-    clearInterval(this.animationTimer);
-    this.animationTimer = undefined;
+  private tipLines(width: number, theme: Theme): string[] {
+    const indent = "  ";
+    const text = `${theme.fg("text", theme.bold("Tip:"))}${theme.fg("dim", ` ${this.tip}`)}`;
+    return wrapTextWithAnsi(text, width - indent.length)
+      .map((line) => padRight(`${indent}${line}`, width));
   }
 
   render(width: number): string[] {
     if (width <= 0) return [];
     const theme = this.ctx.ui.theme;
-    if (width < 16) return [truncateToWidth(theme.fg("accent", `Pi v${VERSION}`), width, "")];
-
-    const innerWidth = width - 2;
-    const isTwoColumn = innerWidth >= 64;
-    const provider = extractProvider(this.ctx.model);
-    const rawModel = this.ctx.model?.id ?? this.ctx.model?.name;
-    const model = rawModel
-      ? provider && !rawModel.startsWith(`${provider}/`) ? `${provider}/${rawModel}` : rawModel
-      : "Default model";
-    const effort = this.pi.getThinkingLevel();
-    const cwd = formatCwd(this.ctx.cwd);
-    const leftWidth = isTwoColumn ? Math.min(LEFT_PANEL_WIDTH, Math.floor(innerWidth * 0.55)) : innerWidth;
-    const rightWidth = isTwoColumn ? innerWidth - leftWidth - 3 : 0;
-    const logoLines = leftWidth >= ORCA_WIDTH * visibleWidth(LOGO_CELL)
-      ? piLogoFrame(this.frame).map((line) => center(line, leftWidth))
-      : ["", "", center(brand(theme.bold("Pi Coding Agent")), leftWidth), "", "", "", ""];
-    const modelText = leftWidth < 34 ? `${model} (${effort})` : `${model} with ${effort} effort`;
-    const leftLines = [
-      ...logoLines,
-      center(theme.bold("Let's build something great"), leftWidth),
-      center(theme.fg("muted", truncateToWidth(modelText, leftWidth, "…")), leftWidth),
-      center(theme.fg("dim", truncateToWidth(cwd, leftWidth, "…")), leftWidth),
+    if (width < 28) return [truncateToWidth(theme.fg("text", theme.bold("KillerOS")), width, "")];
+
+    const panelWidth = Math.min(width, COMPACT_HEADER_MAX_WIDTH);
+    const innerWidth = panelWidth - 4;
+    const version = KILLEROS_VERSION ? theme.fg("dim", ` (v${KILLEROS_VERSION})`) : "";
+    const identity = `${theme.fg("dim", "›")} ${theme.fg("text", theme.bold("KillerOS"))}${version}`;
+    const thinkingLevel = this.pi.getThinkingLevel() as ThinkingLevel;
+    const reasoning = this.ctx.model?.reasoning === false
+      ? theme.fg("thinkingOff", "no reasoning")
+      : theme.fg(LEVEL_COLORS[thinkingLevel], thinkingLevel);
+    const agent = `${formatModel(this.ctx.model, theme)}${theme.fg("dim", " · ")}${reasoning}`;
+    const directory = formatCwd(this.ctx.cwd);
+    const repository = this.branch
+      ? `${directory} ${theme.fg("dim", `· ${this.branch}`)}`
+      : directory;
+    const modelCommand = commandBlue("/model");
+    const agentWidth = Math.max(0, innerWidth - visibleWidth(modelCommand) - 1);
+    const agentCommand = `${truncateToWidth(agent, agentWidth, "…")} ${modelCommand}`;
+    const border = (left: string, right: string): string => theme.fg("dim", `${left}${"─".repeat(panelWidth - 2)}${right}`);
+    const lines = [
+      border("╭", "╮"),
+      compactBoxLine(identity, panelWidth, theme),
+      compactBoxLine("", panelWidth, theme),
+      compactBoxLine(agentCommand, panelWidth, theme),
+      compactBoxLine(repository, panelWidth, theme),
+      border("╰", "╯"),
+      " ".repeat(panelWidth),
+      ...this.tipLines(panelWidth, theme),
     ];
-    const tipLines = isTwoColumn ? getTipLines(this.tipIndex, theme) : [];
-    const lines = [borderLine("╭", `${brand("Pi")} v${VERSION}`, "╮", width)];
-    for (let index = 0; index < leftLines.length; index += 1) {
-      const content = isTwoColumn
-        ? twoColumn(leftLines[index] ?? "", tipLines[index] ?? "", leftWidth, rightWidth)
-        : padRight(leftLines[index] ?? "", leftWidth);
-      lines.push(boxedLine(content, width));
-    }
-    lines.push(borderLine("╰", "", "╯", width));
-    return lines.map((line) => truncateToWidth(line, width, ""));
+    return lines;
   }
 
   invalidate(): void {}
-
-  dispose(): void {
-    if (this.disposed) return;
-    this.disposed = true;
-    this.stopAnimation();
-    if (this.tipTimer) {
-      clearInterval(this.tipTimer);
-      this.tipTimer = undefined;
-    }
-  }
+  dispose(): void {}
 }
 
 const ANSI_REGEX = /\x1b(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
@@ -372,30 +245,57 @@ function reportError(ctx: ExtensionContext, area: string, error: unknown): void
   ctx.ui.notify(`${area}: ${message}`, "error");
 }
 
+const ACTIVITY_WORDS = ["Brewing", "Pondering", "Tinkering", "Wrangling", "Noodling", "Cooking"] as const;
+
 function registerShellUi(pi: ExtensionAPI): void {
   let activeHeader: PiStartupHeader | undefined;
+  let activityWordIndex = 0;
+  let tipDeck: string[] = [];
+  const nextStartupTip = (): string => {
+    if (tipDeck.length === 0) tipDeck = shuffledTips();
+    return tipDeck.pop() ?? STARTUP_TIPS[0];
+  };
 
   pi.on("session_start", (_event, ctx) => {
     if (ctx.mode !== "tui") return;
     try {
-      ctx.ui.setHeader((tui) => {
+      ctx.ui.setTheme("killeros");
+      const startupTip = nextStartupTip();
+      ctx.ui.setHeader(() => {
         activeHeader?.dispose();
-        activeHeader = new PiStartupHeader(pi, ctx, tui);
+        activeHeader = new PiStartupHeader(pi, ctx, startupTip);
         return activeHeader;
       });
       ctx.ui.setWorkingIndicator({
-        frames: ["◐", "◓", "◑", "◒"].map((frame) => ctx.ui.theme.fg("accent", frame)),
-        intervalMs: 120,
+        frames: [
+          ctx.ui.theme.fg("dim", "✻"),
+          ctx.ui.theme.fg("muted", "✻"),
+          ctx.ui.theme.fg("accent", "✻"),
+          ctx.ui.theme.fg("muted", "✻"),
+        ],
+        intervalMs: 180,
       });
+      ctx.ui.setHiddenThinkingLabel("└ Thinking…");
       ctx.ui.setEditorComponent((tui, theme, keybindings) => new PiCodeEditor(tui, theme, keybindings));
     } catch (error) {
       reportError(ctx, "Killeros UI failed to initialize", error);
     }
   });
 
+  pi.on("agent_start", (_event, ctx) => {
+    if (ctx.mode !== "tui") return;
+    ctx.ui.setWorkingMessage(`${ACTIVITY_WORDS[activityWordIndex]}…`);
+    activityWordIndex = (activityWordIndex + 1) % ACTIVITY_WORDS.length;
+  });
+
+  pi.on("agent_end", (_event, ctx) => {
+    if (ctx.mode === "tui") ctx.ui.setWorkingMessage();
+  });
+
   pi.on("session_shutdown", () => {
     activeHeader?.dispose();
     activeHeader = undefined;
+    activityWordIndex = 0;
   });
 }
 
@@ -1089,10 +989,6 @@ export function formatCost(usd: number): string {
   return `$${usd.toFixed(2)}`;
 }
 
-export function resolveShortcutHint(): string {
-  return process.env.PI_SHORTCUT_HINT?.trim() || "/variants";
-}
-
 function formatTime(milliseconds: number): string {
   const totalSeconds = Math.max(0, Math.floor(milliseconds / 1_000));
   if (totalSeconds < 60) return `${totalSeconds}s`;
@@ -1104,20 +1000,22 @@ function formatTime(milliseconds: number): string {
 function formatTokens(value: number): string {
   const amount = Math.max(0, value);
   if (amount < 1_000) return `${Math.round(amount)}`;
-  if (amount >= 1_000_000) return `${(amount / 1_000_000).toFixed(amount >= 10_000_000 ? 0 : 1)}M`;
-  return `${(amount / 1_000).toFixed(amount >= 100_000 ? 0 : 1)}k`;
+  if (amount >= 1_000_000) {
+    const precision = amount >= 10_000_000 ? 0 : 1;
+    return `${Number((amount / 1_000_000).toFixed(precision))}M`;
+  }
+  const precision = amount >= 100_000 ? 0 : 1;
+  return `${Number((amount / 1_000).toFixed(precision))}k`;
 }
 
 export function formatContextProgress(tokensUsed: number | null, contextWindow: number, theme: Theme): string {
-  if (tokensUsed === null) return theme.fg("dim", "[░░░░░░░░░░] —");
+  if (tokensUsed === null) return theme.fg("dim", "—% left (—)");
   const windowSize = contextWindow > 0 ? contextWindow : 128_000;
   const remaining = Math.max(0, Math.min(windowSize, windowSize - Math.max(0, tokensUsed)));
   const percentLeft = Math.max(0, Math.min(100, Math.round((remaining / windowSize) * 100)));
-  const filled = Math.round((percentLeft / 100) * 10);
-  const bar = "█".repeat(filled) + "░".repeat(10 - filled);
   const color: ThemeColor = percentLeft < 20 ? "error" : percentLeft <= 50 ? "warning" : "success";
-  const warning = percentLeft < 15 ? " ⚠ /compact" : "";
-  return theme.fg(color, `[${bar}] ${percentLeft}% left (${formatTokens(remaining)})${warning}`);
+  const action = percentLeft < 15 ? " · /compact" : "";
+  return theme.fg(color, `${percentLeft}% left (${formatTokens(remaining)})${action}`);
 }
 
 function sumSessionCost(ctx: ExtensionContext): number {
@@ -1133,9 +1031,80 @@ function sumSessionCost(ctx: ExtensionContext): number {
   return total;
 }
 
-function formatModel(model: ExtensionContext["model"], theme: Theme): string {
-  if (!model) return theme.fg("dim", "no model");
-  return `${theme.fg("dim", `${model.provider}/`)}${theme.fg("accent", model.id)}`;
+const PROVIDER_LABELS: Readonly<Record<string, string>> = {
+  "amazon-bedrock": "Amazon Bedrock",
+  "azure-openai-responses": "Azure OpenAI",
+  "github-copilot": "GitHub Copilot",
+  "google-vertex": "Google Vertex",
+  "openai-codex": "OpenAI",
+  anthropic: "Anthropic",
+  deepseek: "DeepSeek",
+  google: "Google",
+  ollama: "Ollama",
+  openai: "OpenAI",
+  openrouter: "OpenRouter",
+};
+
+const PROVIDER_WORDS: Readonly<Record<string, string>> = {
+  ai: "AI",
+  api: "API",
+  deepseek: "DeepSeek",
+  github: "GitHub",
+  llm: "LLM",
+  openai: "OpenAI",
+  openrouter: "OpenRouter",
+};
+
+function formatProviderName(provider: string): string {
+  const normalized = provider.trim();
+  const known = PROVIDER_LABELS[normalized.toLocaleLowerCase()];
+  if (known) return known;
+  return normalized
+    .split(/[-_]+/u)
+    .filter(Boolean)
+    .map((word) => PROVIDER_WORDS[word.toLocaleLowerCase()] ?? `${word.charAt(0).toLocaleUpperCase()}${word.slice(1)}`)
+    .join(" ") || "Unknown provider";
+}
+
+function modelDisplayName(model: NonNullable<ExtensionContext["model"]>): string {
+  return model.name?.trim() || model.id;
+}
+
+function formatModel(model: ExtensionContext["model"], theme: Theme, includeProvider = true): string {
+  if (!model) return theme.fg("dim", "No model");
+  const name = theme.fg("text", theme.bold(modelDisplayName(model)));
+  return includeProvider ? `${name} ${theme.fg("dim", formatProviderName(model.provider))}` : name;
+}
+
+function compactDirectory(cwd: string): string {
+  if (cwd === "~" || cwd === "/" || /^[A-Za-z]:[\\/]?$/u.test(cwd)) return cwd;
+  const normalized = cwd.replace(/\\/gu, "/").replace(/\/$/u, "");
+  const finalSegment = normalized.split("/").at(-1);
+  return finalSegment ? `…/${finalSegment}` : cwd;
+}
+
+function joinFooterParts(parts: string[], theme: Theme): string {
+  return parts.filter(Boolean).join(theme.fg("dim", " · "));
+}
+
+function footerRowFits(left: string, right: string, width: number): boolean {
+  const contentWidth = visibleWidth(left) + (right ? visibleWidth(right) + 1 : 0);
+  return contentWidth + 2 <= width;
+}
+
+function renderFooterRow(left: string, right: string, width: number): string {
+  if (width <= 0) return "";
+  if (width < 3) return " ".repeat(width);
+
+  const innerWidth = width - 2;
+  if (!right) return ` ${padRight(left, innerWidth)} `;
+
+  const clippedRight = truncateToWidth(right, innerWidth, "");
+  const rightWidth = visibleWidth(clippedRight);
+  const leftBudget = Math.max(0, innerWidth - rightWidth - 1);
+  const clippedLeft = truncateToWidth(left, leftBudget, "…");
+  const gap = " ".repeat(Math.max(0, innerWidth - visibleWidth(clippedLeft) - rightWidth));
+  return ` ${clippedLeft}${gap}${clippedRight} `;
 }
 
 function registerFooter(pi: ExtensionAPI): void {
@@ -1167,27 +1136,39 @@ function registerFooter(pi: ExtensionAPI): void {
           const model = currentModel ?? ctx.model;
           const level = model?.reasoning === false
             ? theme.fg("thinkingOff", "no reasoning")
-            : theme.fg(LEVEL_COLORS[thinkingLevel], LEVEL_LABELS[thinkingLevel]);
+            : theme.fg(LEVEL_COLORS[thinkingLevel], thinkingLevel);
           const usage = ctx.getContextUsage();
-          const context = formatContextProgress(usage?.tokens ?? null, usage?.contextWindow ?? 128_000, theme);
+          const contextWindow = usage?.contextWindow ?? model?.contextWindow ?? 128_000;
+          const context = formatContextProgress(usage?.tokens ?? null, contextWindow, theme);
           const branch = footerData.getGitBranch();
-          const parts = [
-            formatModel(model, theme),
+          const signature = formatModel(model, theme);
+          const fullDirectory = theme.fg("dim", cwd);
+          const focusedDirectory = theme.fg("dim", compactDirectory(cwd));
+          const rich = joinFooterParts([
+            signature,
             level,
             context,
             branch ? theme.fg("dim", branch) : "",
             theme.fg("dim", formatTime(Date.now() - sessionStart)),
-          ];
-          const cost = sumSessionCost(ctx);
-          if (cost > 0) parts.push(theme.fg("dim", formatCost(cost)));
-          const hint = resolveShortcutHint();
-          if (hint) parts.push(theme.fg("dim", hint));
-          const separator = theme.fg("dim", "·");
-          const left = ` ${parts.filter(Boolean).join(`  ${separator}  `)} `;
-          const rightBudget = Math.max(0, width - visibleWidth(left) - 1);
-          const right = theme.fg("dim", truncateToWidth(cwd, rightBudget, "…"));
-          const gap = " ".repeat(Math.max(1, width - visibleWidth(left) - visibleWidth(right)));
-          return [truncateToWidth(left + gap + right, width, "")];
+            theme.fg("dim", formatCost(sumSessionCost(ctx))),
+          ], theme);
+          const focused = joinFooterParts([signature, context], theme);
+
+          if (footerRowFits(rich, fullDirectory, width)) {
+            return [renderFooterRow(rich, fullDirectory, width)];
+          }
+          if (footerRowFits(rich, focusedDirectory, width)) {
+            return [renderFooterRow(rich, focusedDirectory, width)];
+          }
+          if (footerRowFits(focused, focusedDirectory, width)) {
+            return [renderFooterRow(focused, focusedDirectory, width)];
+          }
+          if (footerRowFits(focused, "", width)) {
+            return [renderFooterRow(focused, "", width)];
+          }
+
+          const essentialModel = formatModel(model, theme, false);
+          return [renderFooterRow(essentialModel, context, width)];
         },
       };
     });

package/README.md

@@ -29,16 +29,18 @@ pi install git:github.com/KyrosHendrix/pi-KillerOS
 Pin an install to a release:
 
 ```bash
-pi install git:github.com/KyrosHendrix/pi-KillerOS@v1.0.0
+pi install git:github.com/KyrosHendrix/pi-KillerOS@v1.2.0
 ```
 
 Add `-l` to either command for a project-only install. Restart Pi after installing.
 
 ## Features
 
-- Animated startup header with current model, reasoning level, and working-directory context
+- 52-column Compact startup card with inline version, polished model/provider identity, adjacent `/model`, directory, conditional Git branch, and a shuffled session-stable tip
+- Cohesive dark theme with coral accents and neutral tool-call containers across pending, success, and error states
+- Coral Spark activity indicator with Claude-adjacent verbs that advance between agent runs and a quiet hidden-thinking label
 - Framed multiline editor with Shift+Enter support
-- Footer with model, reasoning, context remaining, Git branch, elapsed time, and cost
+- Responsive footer with polished model/provider identity and plain-language context remaining; reasoning, Git branch, elapsed time, cost, and path cut down by available width
 - `/variants` selector and direct reasoning-level arguments
 - `question` tool with filtering, keyboard selection, custom answers, history, cancellation, and resize-safe rendering
 - Mid-prompt slash completion with current Pi `0.82.1` commands, extensions, prompts, and skills
@@ -58,13 +60,9 @@ Supported reasoning levels are `off`, `minimal`, `low`, `medium`, `high`, `xhigh
 
 ## Configuration
 
-KillerOS displays provider costs in USD.
+KillerOS activates its packaged `killeros` theme when a TUI session starts. Tool-call backgrounds stay neutral across pending, successful, and failed states; restrained text and icons preserve status visibility.
 
-Set a custom footer shortcut hint with:
-
-```text
-PI_SHORTCUT_HINT=/variants
-```
+KillerOS displays session costs in USD. The footer uses Pi's human-readable model name when available, keeps the provider visually secondary, and renders context as `percent left (tokens)` without a progress bar.
 
 ## Behavior by mode
 
@@ -83,7 +81,7 @@ npm ci
 npm run check
 npm test
 npm pack --dry-run
-pi -e . --mode rpc
+pi -ne -e . --mode rpc
 ```
 
 The package manifest lists Pi’s built-in modules as peer dependencies, so npm does not bundle a second copy.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "killeros",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "A production-hardened TUI and workflow extension for the Pi coding agent.",
   "type": "module",
   "keywords": [
@@ -21,7 +21,9 @@
   },
   "files": [
     "Killeros.ts",
-    "README.md"
+    "themes/killeros.json",
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.19.0"
@@ -33,6 +35,9 @@
   "pi": {
     "extensions": [
       "./Killeros.ts"
+    ],
+    "themes": [
+      "./themes/killeros.json"
     ]
   },
   "peerDependencies": {

package/themes/killeros.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "killeros",
+  "vars": {
+    "coral": "#d77757",
+    "coralBright": "#e58b6d",
+    "canvas": "#0a0a0a",
+    "surface": "#121212",
+    "surfaceRaised": "#1a1a1a",
+    "line": "#404040",
+    "lineMuted": "#2e2e2e",
+    "text": "#f2f2f2",
+    "muted": "#adadad",
+    "dim": "#808080",
+    "success": "#8fa88b",
+    "error": "#c8786c",
+    "warning": "#bda36c",
+    "pink": "#b98aa5"
+  },
+  "colors": {
+    "accent": "coral",
+    "border": "line",
+    "borderAccent": "coral",
+    "borderMuted": "lineMuted",
+    "success": "success",
+    "error": "error",
+    "warning": "warning",
+    "muted": "muted",
+    "dim": "dim",
+    "text": "text",
+    "thinkingText": "muted",
+
+    "selectedBg": "surfaceRaised",
+    "userMessageBg": "surface",
+    "userMessageText": "text",
+    "customMessageBg": "surface",
+    "customMessageText": "text",
+    "customMessageLabel": "coralBright",
+    "toolPendingBg": "surface",
+    "toolSuccessBg": "surface",
+    "toolErrorBg": "surface",
+    "toolTitle": "coralBright",
+    "toolOutput": "muted",
+
+    "mdHeading": "coralBright",
+    "mdLink": "coralBright",
+    "mdLinkUrl": "dim",
+    "mdCode": "coralBright",
+    "mdCodeBlock": "text",
+    "mdCodeBlockBorder": "lineMuted",
+    "mdQuote": "muted",
+    "mdQuoteBorder": "line",
+    "mdHr": "line",
+    "mdListBullet": "coral",
+
+    "toolDiffAdded": "success",
+    "toolDiffRemoved": "error",
+    "toolDiffContext": "muted",
+
+    "syntaxComment": "dim",
+    "syntaxKeyword": "coralBright",
+    "syntaxFunction": "#c9a48d",
+    "syntaxVariable": "#b7c0c8",
+    "syntaxString": "#a9b78d",
+    "syntaxNumber": "#c5a77a",
+    "syntaxType": "#a3afb8",
+    "syntaxOperator": "muted",
+    "syntaxPunctuation": "muted",
+
+    "thinkingOff": "dim",
+    "thinkingMinimal": "#78685f",
+    "thinkingLow": "#98705f",
+    "thinkingMedium": "#b27762",
+    "thinkingHigh": "coral",
+    "thinkingXhigh": "#d58272",
+    "thinkingMax": "pink",
+
+    "bashMode": "warning"
+  },
+  "export": {
+    "pageBg": "#0a0a0a",
+    "cardBg": "#121212",
+    "infoBg": "#1a1a1a"
+  }
+}