portable-agent-layer 0.49.0 → 0.50.0

package/assets/STATUSLINE.md

@@ -47,6 +47,28 @@ chmod +x ~/.claude/statusline.sh
 
 The statusline script is at: `portable-agent-layer/assets/statusline.sh`
 
+### Cursor CLI
+
+1. Make the script executable:
+```bash
+chmod +x ~/.cursor/statusline.sh
+```
+
+2. Add to `~/.cursor/cli-config.json`:
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "~/.cursor/statusline.sh",
+    "padding": 2
+  }
+}
+```
+
+Copy `assets/statusline.sh` to `~/.cursor/statusline.sh` (or symlink). Restart the Cursor CLI after editing config.
+
+On Cursor, session cost and rate limits are usually absent from stdin — the script omits the cost segment and hides rate limits automatically. PAL indicators (hooks, ISCs, signal, update) still read from `~/.pal/memory/state/`.
+
 ### On Windows
 
 1. Add to `~/.claude/settings.json`:

package/assets/statusline.sh

@@ -1,49 +1,57 @@
 #!/bin/bash
 # PAL Status Line — macOS/Linux
-# Reads JSON from stdin (Claude Code session data) and prints a formatted status line
+# Reads JSON from stdin (Claude Code / Cursor CLI session data) and prints a formatted status line
 
 input=$(cat)
 
-# Extract data with fallbacks
+# Empty or invalid stdin — keep previous status line (Cursor may invoke early)
+if [ -z "$input" ] || ! echo "$input" | jq -e . >/dev/null 2>&1; then
+  exit 0
+fi
+
+# Extract data with fallbacks (Cursor: cwd, worktree.name; Claude: workspace, worktree.branch)
 MODEL=$(echo "$input" | jq -r '.model.display_name // "Unknown"')
 USED_RAW=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
 REM_RAW=$(echo "$input" | jq -r '.context_window.remaining_percentage // empty')
 USED=$( [ -n "$USED_RAW" ] && echo "${USED_RAW%.*}" || echo 0 )
 REMAINING=$( [ -n "$REM_RAW" ] && echo "${REM_RAW%.*}" || echo 0 )
-COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
-CWD=$(echo "$input" | jq -r '.workspace.current_dir // "~"')
+CWD=$(echo "$input" | jq -r '.workspace.current_dir // .cwd // "~"')
 REPO=$(echo "$input" | jq -r '.workspace.repo.name // ""')
 
 # No data yet (pre-first API call)
 if [ -z "$USED_RAW" ] && [ -z "$REM_RAW" ]; then
-  USED=0; REMAINING=100
+  USED=0
+  REMAINING=100
 fi
 
-# Extract git branch — try multiple sources for robustness
-BRANCH=$(echo "$input" | jq -r '.worktree.branch // ""')
-if [ -z "$BRANCH" ]; then
+# Git branch — payload first, then git in cwd
+BRANCH=$(echo "$input" | jq -r '.worktree.branch // .worktree.name // ""')
+if [ -z "$BRANCH" ] || [ "$BRANCH" = "null" ]; then
   BRANCH=$(git -C "$CWD" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
 fi
 
-# Format directory — show repo name if available, else just folder name
-if [ -n "$REPO" ]; then
+# Directory label
+if [ -n "$REPO" ] && [ "$REPO" != "null" ]; then
   DIR_DISPLAY="$REPO"
 else
   DIR_DISPLAY="${CWD##*/}"
 fi
 
-# Format git branch with emoji indicator
 if [ -n "$BRANCH" ]; then
   GIT_INDICATOR="  (🌿 ${BRANCH})"
 else
   GIT_INDICATOR=""
 fi
 
-# Format cost — show as $X.XX or 'free' if < $0.01
-if (( $(echo "$COST < 0.01" | bc -l) )); then
-  COST_STR="free"
-else
-  COST_STR=$(printf '$%.2f' "$COST")
+# Session cost — Claude only; omit segment when absent (Cursor does not send cost)
+COST_STR=""
+if echo "$input" | jq -e '.cost.total_cost_usd != null' >/dev/null 2>&1; then
+  COST=$(echo "$input" | jq -r '.cost.total_cost_usd')
+  if (( $(echo "$COST < 0.01" | bc -l) )); then
+    COST_STR="free"
+  else
+    COST_STR=$(printf '$%.2f' "$COST")
+  fi
 fi
 
 # PAL: Hook health — count ERROR lines in debug.log from last 24h
@@ -76,7 +84,7 @@ if [ -d "$PROJECTS_DIR" ]; then
   done
 fi
 
-# Rate limits (Pro/Max only — absent for other plans)
+# Rate limits (Pro/Max only — absent for other plans and on Cursor)
 FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
 SEVEN_D=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
 RATE_PARTS=()
@@ -159,8 +167,12 @@ ISC_STR=""
 # Line 1: Model, Directory, Git Branch, Hook Health, Open ISCs, Signal
 echo -e "${CYAN}[${MODEL}]${RESET} 📁 ${DIR_DISPLAY}${DIM}${GIT_INDICATOR}${RESET}${HOOK_STR}${ISC_STR}${SIGNAL_STR}"
 
-# Line 2: Context bar with usage percentage, cost, and rate limits
-echo -e "${CONTEXT_COLOR}${BAR}${RESET} ${USED}% │ ${COST_STR} │ ${REMAINING}% free${DIM}${RATE_STR}${RESET}"
+# Line 2: Context bar; cost segment only when Claude sends it
+if [ -n "$COST_STR" ]; then
+  echo -e "${CONTEXT_COLOR}${BAR}${RESET} ${USED}% │ ${COST_STR} │ ${REMAINING}% free${DIM}${RATE_STR}${RESET}"
+else
+  echo -e "${CONTEXT_COLOR}${BAR}${RESET} ${USED}% │ ${REMAINING}% free${DIM}${RATE_STR}${RESET}"
+fi
 
 # Line 3: Update available (only when cache says available AND versions differ)
 [ -n "$UPDATE_LINE" ] && echo -e "${YELLOW}${UPDATE_LINE}${RESET}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {

package/src/hooks/handlers/update-check.ts

@@ -1,8 +1,8 @@
 /**
  * Update checker — detects if a newer version of PAL is available.
  *
- * Repo mode (.git exists next to package): git fetch + compare HEAD vs origin/main
  * Package mode: fetch npm registry for latest version vs installed
+ * Repo mode: opt in with PAL_UPDATE_MODE=repo to compare HEAD vs origin/main
  *
  * Caches result in state/update-available.json. Checked at most once per hour.
  */
@@ -47,7 +47,7 @@ function writeCache(cache: UpdateCache): void {
 }
 
 function isRepoMode(): boolean {
-  return existsSync(resolve(palPkg(), ".git"));
+  return process.env.PAL_UPDATE_MODE === "repo" && existsSync(resolve(palPkg(), ".git"));
 }
 
 function getInstalledVersion(): string {

package/src/targets/codex/install.ts

@@ -15,6 +15,7 @@ import { resolve } from "node:path";
 import { regenerateIfNeeded } from "../../hooks/lib/claude-md";
 import { assets, palPkg, platform } from "../../hooks/lib/paths";
 import {
+  addCodexStatuslineConfig,
   copySkills,
   countSkills,
   generateSkillIndex,
@@ -55,6 +56,17 @@ function enableCodexHooks(configPath: string): void {
   log.success("Enabled hooks = true in ~/.codex/config.toml");
 }
 
+function enableCodexStatusline(configPath: string): void {
+  const content = existsSync(configPath) ? readFileSync(configPath, "utf-8") : "";
+  const updated = addCodexStatuslineConfig(content);
+  if (updated === content) {
+    log.info("Codex status line already configured in config.toml");
+    return;
+  }
+  writeFileSync(configPath, updated, "utf-8");
+  log.success("Configured Codex TUI status line in ~/.codex/config.toml");
+}
+
 const PKG_ROOT = palPkg().replaceAll("\\", "/");
 const CODEX_DIR = platform.codexDir();
 const HOOKS_FILE = resolve(CODEX_DIR, "hooks.json");
@@ -102,6 +114,7 @@ log.success("Ensured AGENTS.md symlink at ~/.codex/AGENTS.md");
 // --- Enable hooks in config.toml ---
 const CONFIG_FILE = resolve(CODEX_DIR, "config.toml");
 enableCodexHooks(CONFIG_FILE);
+enableCodexStatusline(CONFIG_FILE);
 
 log.success("Codex installation complete");
 console.log("");

package/src/targets/codex/uninstall.ts

@@ -11,6 +11,7 @@ import {
   loadCodexHooksTemplate,
   log,
   readJson,
+  removeCodexStatuslineConfig,
   removeSkills,
   unmergeCodexHooks,
   unmergeCodexRules,
@@ -36,6 +37,15 @@ function disableCodexHooks(configPath: string): void {
   log.success("Removed hooks from ~/.codex/config.toml");
 }
 
+function disableCodexStatusline(configPath: string): void {
+  if (!existsSync(configPath)) return;
+  const content = readFileSync(configPath, "utf-8");
+  const updated = removeCodexStatuslineConfig(content);
+  if (updated === content) return;
+  writeFileSync(configPath, updated, "utf-8");
+  log.success("Removed PAL Codex status line from ~/.codex/config.toml");
+}
+
 const PKG_ROOT = palPkg().replaceAll("\\", "/");
 const CODEX_DIR = platform.codexDir();
 const HOOKS_FILE = resolve(CODEX_DIR, "hooks.json");
@@ -80,5 +90,6 @@ if (removed.length > 0) {
 // --- Disable hooks in config.toml ---
 const CONFIG_FILE = resolve(CODEX_DIR, "config.toml");
 disableCodexHooks(CONFIG_FILE);
+disableCodexStatusline(CONFIG_FILE);
 
 log.success("Codex uninstall complete");

package/src/targets/cursor/install.ts

@@ -4,15 +4,17 @@
  * Symlinks skills. Generates AGENTS.md.
  */
 
-import { copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { copyFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { writeContextDigests } from "../../hooks/handlers/context-digests";
 import { regenerateIfNeeded } from "../../hooks/lib/claude-md";
 import { assets, palPkg, platform } from "../../hooks/lib/paths";
 import {
+  addStatuslineConfig,
   copyAgentsForCursor,
   copyPalDocs,
   copySkills,
+  copyStatusline,
   countSkills,
   generateSkillIndex,
   loadCursorHooksTemplate,
@@ -26,6 +28,7 @@ import {
 const PKG_ROOT = palPkg().replaceAll("\\", "/");
 const CURSOR_DIR = platform.cursorDir();
 const HOOKS_FILE = resolve(CURSOR_DIR, "hooks.json");
+const CLI_CONFIG = resolve(CURSOR_DIR, "cli-config.json");
 
 // --- Ensure ~/.cursor/ exists ---
 mkdirSync(CURSOR_DIR, { recursive: true });
@@ -61,6 +64,19 @@ log.success(`Installed ${palDocsCount} PAL docs to ~/.pal/docs/`);
 // --- Scaffold PAL settings ---
 scaffoldPalSettings();
 
+// --- Statusline script + cli-config.json statusLine ---
+copyStatusline("cursor");
+if (!existsSync(CLI_CONFIG)) {
+  writeFileSync(CLI_CONFIG, "{}\n", "utf-8");
+  log.info("Created new cli-config.json");
+} else {
+  copyFileSync(CLI_CONFIG, `${CLI_CONFIG}.bak.${Date.now()}`);
+  log.info("Backed up cli-config.json");
+}
+const cliConfig = readJson<Record<string, unknown>>(CLI_CONFIG, {});
+writeJson(CLI_CONFIG, addStatuslineConfig(cliConfig, "cursor"));
+log.success("Merged statusLine into cli-config.json");
+
 // --- Generate AGENTS.md ---
 regenerateIfNeeded();
 log.success("Generated AGENTS.md");

package/src/targets/cursor/uninstall.ts

@@ -15,6 +15,8 @@ import {
   removeAgentsFromCursor,
   removePalDocs,
   removeSkills,
+  removeStatusline,
+  removeStatuslineConfig,
   unmergeCursorHooks,
   writeJson,
 } from "../lib";
@@ -22,6 +24,7 @@ import {
 const PKG_ROOT = palPkg().replaceAll("\\", "/");
 const CURSOR_DIR = platform.cursorDir();
 const HOOKS_FILE = resolve(CURSOR_DIR, "hooks.json");
+const CLI_CONFIG = resolve(CURSOR_DIR, "cli-config.json");
 
 // --- Remove PAL hooks from hooks.json ---
 if (existsSync(HOOKS_FILE)) {
@@ -57,6 +60,18 @@ if (removedAgents.length > 0) {
 // --- Remove PAL system docs ---
 removePalDocs();
 
+// --- Remove statusline script and cli-config statusLine ---
+if (existsSync(CLI_CONFIG)) {
+  copyFileSync(CLI_CONFIG, `${CLI_CONFIG}.bak.${Date.now()}`);
+  log.info("Backed up cli-config.json");
+  const cliConfig = readJson<Record<string, unknown>>(CLI_CONFIG, {});
+  writeJson(CLI_CONFIG, removeStatuslineConfig(cliConfig, "cursor"));
+  log.success("Removed PAL statusLine from cli-config.json");
+} else {
+  log.info("No cli-config.json found, skipping statusLine removal");
+}
+removeStatusline("cursor");
+
 // --- Remove ~/.cursor/rules/pal-*.mdc ---
 for (const src of getSemiStaticSources()) {
   try {

package/src/targets/lib.ts

@@ -485,6 +485,69 @@ export function unmergeCodexRules(existing: string): string {
   return cleaned ? `${cleaned}\n` : "";
 }
 
+// --- Codex TUI status line ---
+
+const PAL_CODEX_STATUS_LINE = [
+  "model-with-reasoning",
+  "context-remaining",
+  "context-used",
+  "five-hour-limit",
+  "weekly-limit",
+  "git-branch",
+  "used-tokens",
+  "thread-id",
+  "current-dir",
+  "codex-version",
+] as const;
+
+function codexStatusLineToml(): string {
+  const quotedItems = PAL_CODEX_STATUS_LINE.map((item) => JSON.stringify(item)).join(
+    ", "
+  );
+  return `tui.status_line = [${quotedItems}]\ntui.status_line_use_colors = true\n`;
+}
+
+function hasCodexStatusLine(content: string): boolean {
+  return /^[ \t]*(?:tui\.)?status_line[ \t]*=/m.test(content);
+}
+
+/** Add Codex TUI status-line defaults unless the user already configured one. */
+export function addCodexStatuslineConfig(content: string): string {
+  if (hasCodexStatusLine(content)) return content;
+
+  const block = codexStatusLineToml();
+  if (content.trim() === "") return block;
+
+  const firstTable = content.search(/^[ \t]*\[/m);
+  if (firstTable === -1) {
+    return `${content}${content.endsWith("\n") ? "" : "\n"}${block}`;
+  }
+
+  const before = content.slice(0, firstTable);
+  const after = content.slice(firstTable);
+  return `${before}${before.endsWith("\n") || before === "" ? "" : "\n"}${block}\n${after}`;
+}
+
+/** Remove PAL's default Codex status-line config if it still matches exactly. */
+export function removeCodexStatuslineConfig(content: string): string {
+  const lines = content.split("\n");
+  const statusLine = codexStatusLineToml().trim().split("\n")[0];
+  const colors = codexStatusLineToml().trim().split("\n")[1];
+  const filtered: string[] = [];
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]?.trim();
+    const next = lines[i + 1]?.trim();
+    if (line === statusLine && next === colors) {
+      i++;
+      continue;
+    }
+    filtered.push(lines[i] ?? "");
+  }
+
+  return filtered.join("\n").replace(/\n{3,}/g, "\n\n");
+}
+
 // --- TELOS scaffolding ---
 
 /** Copy template files into telos/ without overwriting existing ones */
@@ -892,17 +955,41 @@ export function loadCopilotHooksTemplate(templatePath: string, pkgRoot: string):
 
 // --- Statusline ---
 
-/** Copy statusline script to ~/.claude/ for the current platform */
-export function copyStatusline(): boolean {
-  const claudeDir = platform.claudeDir();
-  mkdirSync(claudeDir, { recursive: true });
+export type StatuslineTarget = "claude" | "cursor";
+
+function statuslineAgentDir(target: StatuslineTarget): string {
+  return target === "claude" ? platform.claudeDir() : platform.cursorDir();
+}
+
+function statuslineCommand(target: StatuslineTarget): string {
+  const isPlatformWin32 = process.platform === "win32";
+  if (target === "cursor") {
+    return isPlatformWin32
+      ? "powershell -NoProfile -File ~/.cursor/statusline.ps1"
+      : "~/.cursor/statusline.sh";
+  }
+  return isPlatformWin32
+    ? "powershell -NoProfile -File ~/.claude/statusline.ps1"
+    : "~/.claude/statusline.sh";
+}
+
+function isPalStatuslineCommand(cmd: string, target: StatuslineTarget): boolean {
+  return target === "claude"
+    ? cmd.includes(".claude/statusline")
+    : cmd.includes(".cursor/statusline");
+}
+
+/** Copy statusline script to ~/.claude/ or ~/.cursor/ for the current platform */
+export function copyStatusline(target: StatuslineTarget = "claude"): boolean {
+  const agentDir = statuslineAgentDir(target);
+  mkdirSync(agentDir, { recursive: true });
 
   const isPlatformWin32 = process.platform === "win32";
   const sourcePath = isPlatformWin32
     ? assets.statuslineScriptPs1()
     : assets.statuslineScriptBash();
   const scriptName = isPlatformWin32 ? "statusline.ps1" : "statusline.sh";
-  const destPath = resolve(claudeDir, scriptName);
+  const destPath = resolve(agentDir, scriptName);
 
   if (!existsSync(sourcePath)) {
     log.warn(`Statusline script not found at ${sourcePath}`);
@@ -912,7 +999,6 @@ export function copyStatusline(): boolean {
   try {
     copyFileSync(sourcePath, destPath);
 
-    // Make executable on Unix
     if (process.platform !== "win32") {
       chmodSync(destPath, 0o755);
     }
@@ -925,12 +1011,11 @@ export function copyStatusline(): boolean {
   }
 }
 
-/** Remove statusline script from ~/.claude/ */
-export function removeStatusline(): boolean {
-  const claudeDir = platform.claudeDir();
+/** Remove statusline script from ~/.claude/ or ~/.cursor/ */
+export function removeStatusline(target: StatuslineTarget = "claude"): boolean {
   const isPlatformWin32 = process.platform === "win32";
   const scriptName = isPlatformWin32 ? "statusline.ps1" : "statusline.sh";
-  const scriptPath = resolve(claudeDir, scriptName);
+  const scriptPath = resolve(statuslineAgentDir(target), scriptName);
 
   if (!existsSync(scriptPath)) {
     log.info("Statusline script not found, nothing to remove");
@@ -947,40 +1032,56 @@ export function removeStatusline(): boolean {
   }
 }
 
-/** Add statusLine config to settings if not already present or if using old broken command */
+/** Add statusLine config if not already present or if using an old broken command */
 export function addStatuslineConfig(
-  settings: Record<string, unknown>
+  settings: Record<string, unknown>,
+  target: StatuslineTarget = "claude"
 ): Record<string, unknown> {
   const statusLine = settings.statusLine as Record<string, unknown> | undefined;
 
-  // Check if already configured with a valid command (not the old broken one)
   if (statusLine && typeof statusLine === "object" && statusLine.command) {
     const cmd = statusLine.command as string;
-    // Keep existing config unless it's the old broken Get-Content pattern
-    if (!cmd.includes("Get-Content -Raw")) {
+    if (target === "claude") {
+      // Keep existing config unless it's the old broken Get-Content pattern
+      if (!cmd.includes("Get-Content -Raw")) {
+        return settings;
+      }
+    } else if (!isPalStatuslineCommand(cmd, "cursor")) {
+      // Cursor: preserve user-defined statusLine commands
       return settings;
     }
   }
 
-  const isPlatformWin32 = process.platform === "win32";
-  const command = isPlatformWin32
-    ? "powershell -NoProfile -File ~/.claude/statusline.ps1"
-    : "~/.claude/statusline.sh";
-
+  const command = statuslineCommand(target);
   settings.statusLine = {
     type: "command",
     command,
     padding: 2,
+    ...(target === "cursor" ? { updateIntervalMs: 300, timeoutMs: 2000 } : {}),
   };
 
   return settings;
 }
 
-/** Remove statusLine config from settings */
+/** Remove statusLine config from settings (PAL-owned only for Cursor) */
 export function removeStatuslineConfig(
-  settings: Record<string, unknown>
+  settings: Record<string, unknown>,
+  target: StatuslineTarget = "claude"
 ): Record<string, unknown> {
-  delete settings.statusLine;
+  const statusLine = settings.statusLine as Record<string, unknown> | undefined;
+  if (!statusLine || typeof statusLine !== "object") {
+    return settings;
+  }
+
+  if (target === "claude") {
+    delete settings.statusLine;
+    return settings;
+  }
+
+  const cmd = statusLine.command as string | undefined;
+  if (cmd && isPalStatuslineCommand(cmd, "cursor")) {
+    delete settings.statusLine;
+  }
   return settings;
 }