@ammduncan/easel 0.2.13 → 0.2.14

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to easel. This project adheres to [Semantic Versioning](https://semver.org/).
 
+## 0.2.14 — 2026-05-23
+
+### Changed
+- **First-push auto-open is now actually the only trigger.** 0.2.10 moved the MCP-side auto-open from "first tool call" to "first push when no tab is alive". But Claude Code launches were still opening a tab because `easel setup` also installed a `SessionStart` hook that ran `easel open --quiet`. Two changes:
+  - `easel setup` no longer installs the `easel open --quiet` SessionStart block, and actively strips any pre-existing one from `~/.claude/settings.json`. The `idCaptureBlock` (which writes the per-PPID session-id file) stays — it's needed for PPID → session correlation and has no UI side effect.
+  - `mcp.ts` `autoOpenIfNeeded` drops the `hookHasFiredForThisPpid()` short-circuit. That check was a proxy for "the hook already opened a tab"; now that the hook doesn't open tabs, `sessionTabs > 0` is the truthful signal.
+- After upgrading, run `easel update` once so setup re-runs and cleans your existing `~/.claude/settings.json`.
+
 ## 0.2.13 — 2026-05-23
 
 ### Added

package/dist/cli.js

@@ -124,7 +124,8 @@ function cmdSetup() {
     const hooks = settings.hooks ?? {};
     let sessionStart = hooks.SessionStart ?? [];
     // Drop legacy entries from prior versions (the old bash hook, paths under the
-    // claude-display name) before re-adding the current Node-based hook.
+    // claude-display name) AND the prior autoOpenBlock (which opened a tab at
+    // SessionStart — replaced by MCP-side auto-open on first push as of 0.2.14).
     const isLegacy = (block) => {
         const inner = block?.hooks ?? [block];
         if (!Array.isArray(inner))
@@ -135,16 +136,16 @@ function cmdSetup() {
                 return false;
             return (cmd.includes("claude-display-session-id.sh") ||
                 cmd.includes("easel-session-id.sh") ||
-                cmd.includes("bin/claude-display "));
+                cmd.includes("bin/claude-display ") ||
+                // Prior `easel open --quiet` SessionStart hook — superseded by
+                // MCP-side first-push auto-open.
+                (cmd.includes("easel") && cmd.includes("open --quiet")));
         });
     };
     sessionStart = sessionStart.filter((b) => !isLegacy(b));
     const idCaptureBlock = {
         hooks: [{ type: "command", command: `node ${hookScript}` }],
     };
-    const autoOpenBlock = {
-        hooks: [{ type: "command", command: `${cliEntry} open --quiet` }],
-    };
     const containsBlockMatching = (substr) => sessionStart.some((block) => {
         const inner = block?.hooks ?? [block];
         return (Array.isArray(inner) ? inner : []).some((h) => typeof h === "object" &&
@@ -155,9 +156,6 @@ function cmdSetup() {
     if (!containsBlockMatching("easel-session-id.mjs")) {
         sessionStart.push(idCaptureBlock);
     }
-    if (!containsBlockMatching("easel") || !containsBlockMatching("open --quiet")) {
-        sessionStart.push(autoOpenBlock);
-    }
     hooks.SessionStart = sessionStart;
     settings.hooks = hooks;
     mkdirSync(dirname(settingsPath), { recursive: true });

package/dist/mcp.js

@@ -3,11 +3,8 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
 import { ensureHttpServer } from "./server-manager.js";
 import { resolveClaudeSessionId } from "./session-id.js";
-import { HOOK_DIR } from "./paths.js";
 function openUrlInBrowser(url) {
     const platform = process.platform;
     const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
@@ -24,14 +21,6 @@ const TOOL_PUSH = "push";
 const TOOL_OPEN = "open";
 const TOOL_CONFIG = "config";
 const TOOL_LABEL = "label";
-/**
- * True if a SessionStart hook (e.g. Claude Code's) has already written a
- * session-id file for this MCP child's PPID. Tells us a hook-aware client is
- * managing tab lifecycle, so the MCP server should NOT also auto-open.
- */
-function hookHasFiredForThisPpid() {
-    return existsSync(join(HOOK_DIR, `cc-session-${process.ppid}.txt`));
-}
 // One-shot guard: only auto-open once per MCP-child lifetime. If the user
 // closes the tab afterwards, subsequent pushes won't re-open it — the user
 // closing the tab is treated as an explicit dismissal we should respect.
@@ -43,10 +32,16 @@ let autoOpenAttempted = false;
  * - `otherTabs > 0`: easel is open, but on a different session. Don't surprise
  *   the user with another window — return "other-session" so the caller can
  *   tell the agent to ask whether to use the topbar switcher or open a new tab.
- * - both 0 + no hook-managed tab: auto-open one tab.
+ * - both 0: auto-open one tab.
  *
  * One-shot per MCP child lifetime. Closing the tab counts as dismissal;
  * subsequent pushes won't re-open.
+ *
+ * Note: until 0.2.13, this also short-circuited when the Claude Code
+ * SessionStart hook had fired (`hookHasFiredForThisPpid`), because the hook
+ * itself opened a tab. As of 0.2.14 `easel setup` no longer installs that
+ * hook, so the MCP-side decision is reactive to actual tab presence only —
+ * `sessionTabs` is the truthful signal.
  */
 function autoOpenIfNeeded(url, sessionTabs, otherTabs) {
     if (autoOpenAttempted)
@@ -60,11 +55,6 @@ function autoOpenIfNeeded(url, sessionTabs, otherTabs) {
         autoOpenAttempted = true;
         return { kind: "other-session" };
     }
-    if (hookHasFiredForThisPpid()) {
-        // Claude Code's SessionStart hook handled it (or tried to).
-        autoOpenAttempted = true;
-        return { kind: "noop" };
-    }
     autoOpenAttempted = true;
     openUrlInBrowser(url);
     return { kind: "opened" };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ammduncan/easel",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "A live browser tab for every Claude Code (and MCP) session. The push MCP tool appends HTML cards to a scrolling feed you keep open in split-screen.",
   "type": "module",
   "license": "MIT",