portable-agent-layer 0.78.0 → 0.78.1

package/README.md

@@ -63,7 +63,7 @@ alias pal="bun run ~/path/to/portable-agent-layer/src/cli/index.ts"
 
 ```bash
 pal cli init          # scaffold home, install hooks for all targets
-pal                   # start a Claude session (with session summary on exit)
+pal                   # start the first installed agent in the terminal
 pal cli status        # check your setup
 ```
 
@@ -73,7 +73,7 @@ pal cli status        # check your setup
 
 | Command | Description |
 |---------|-------------|
-| `pal` | Start a Claude session with session summary on exit |
+| `pal` | Start the first installed agent, in order: Claude Code, Codex, Cursor CLI, Copilot CLI, opencode. Claude sessions print a summary on exit |
 | `pal cli init` | Scaffold PAL home directory and install hooks |
 | `pal cli install` | Register hooks/skills for targets |
 | `pal cli uninstall` | Remove hooks/skills for targets |

package/package.json

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

package/src/cli/index.ts

@@ -3,7 +3,7 @@
  * PAL CLI — Portable Agent Layer
  *
  * Usage:
- *   pal [claude-args...]              Start a Claude session with session summary on exit
+ *   pal [agent-args...]               Start the first installed agent: claude, codex, cursor-agent, copilot, opencode
  *   pal cli <command> [options]       Admin commands
  *
  * Admin commands (pal cli ...):
@@ -56,6 +56,7 @@ import { findBinaryOnPath } from "../hooks/lib/which";
 import { log } from "../targets/lib";
 import { builtinToolVerbs, runBuiltinTool } from "./builtin-tools";
 import { checkPendingMigrations } from "./migrate";
+import { findSessionAgent, NO_SESSION_AGENT_MESSAGE } from "./session-agent";
 
 const allArgs = process.argv.slice(2);
 
@@ -109,16 +110,10 @@ function checkCopilot(): ToolCheck {
   return cli;
 }
 
-function detectAgent(): string | null {
-  if (checkTool("claude").available) return "claude";
-  if (checkTool("opencode").available) return "opencode";
-  return null;
-}
-
 async function session(sessionArgs: string[]) {
-  const agent = detectAgent();
+  const agent = findSessionAgent();
   if (!agent) {
-    log.error("No supported agent found. Install Claude Code or opencode.");
+    log.error(NO_SESSION_AGENT_MESSAGE);
     process.exit(1);
   }
 
@@ -328,7 +323,7 @@ function pointAtOnboarding(): void {
 function showHelp() {
   console.log(`
   Usage:
-    pal [claude-args...]                    Start a Claude session
+    pal [agent-args...]                     Start the first installed agent
     pal cli <command> [options]             Admin commands
 
   Admin commands:
@@ -1159,7 +1154,7 @@ function doctor(silent = false): DoctorResult {
 
     if (!hasAgent) {
       console.log("");
-      log.error("No supported agent found. Install Claude Code or opencode.");
+      log.error(NO_SESSION_AGENT_MESSAGE);
     }
     console.log("");
   }

package/src/cli/session-agent.ts

@@ -0,0 +1,20 @@
+import { findBinaryOnPath } from "../hooks/lib/which";
+
+const SESSION_AGENT_BINARIES = [
+  "claude",
+  "codex",
+  "cursor-agent",
+  "copilot",
+  "opencode",
+] as const;
+
+export type SessionAgent = (typeof SESSION_AGENT_BINARIES)[number];
+
+export function findSessionAgent(): SessionAgent | null {
+  return (
+    SESSION_AGENT_BINARIES.find((binary) => findBinaryOnPath(binary) !== null) ?? null
+  );
+}
+
+export const NO_SESSION_AGENT_MESSAGE =
+  "No supported agent found. Install Claude Code, Codex, Cursor CLI, Copilot CLI or opencode.";

package/src/hooks/lib/projects.ts

@@ -349,10 +349,11 @@ export function resolveProjectFromCwd(
 
 export function isStale(
   p: ProjectProgress,
-  thresholdDays = PROJECT_STALE_DAYS_DEFAULT
+  thresholdDays = PROJECT_STALE_DAYS_DEFAULT,
+  now: Date = new Date()
 ): boolean {
   if (!p.updated) return false;
-  const age = Date.now() - new Date(p.updated).getTime();
+  const age = now.getTime() - new Date(p.updated).getTime();
   if (!Number.isFinite(age) || age < 0) return false;
   return age > thresholdDays * 86_400_000;
 }

package/src/tools/control-room/data.ts

@@ -16,6 +16,7 @@ import { loadAnalyzeNudge } from "../../hooks/lib/analyze-nudge";
 import { paths } from "../../hooks/lib/paths";
 import {
   isStale,
+  PROJECT_STALE_DAYS_DEFAULT,
   type ProjectProgress,
   readAllProjects,
   type ServesAuthority,
@@ -188,7 +189,7 @@ function toCard(
   snoozes: Record<string, string>
 ): ProjectCard {
   const path = p.path ?? null;
-  const stale = isStale(p);
+  const stale = isStale(p, PROJECT_STALE_DAYS_DEFAULT, now);
   const history = path ? readProjectHistory(path, 1) : [];
   const last = history.at(-1);
   return {