@zhigang1992/happy-cli 0.12.6 → 0.12.9

package/README.md

@@ -1,3 +1,21 @@
+# Happy CLI (Fork)
+
+> **This is a personal fork of [happy-cli](https://github.com/slopus/happy-cli) from the amazing [Happy](https://happy.engineering) project.**
+>
+> All credit goes to the original authors. I've made some tweaks for my own self-hosted setup, but my changes are too scattered and experimental to submit upstream. If you're looking for the official version, please visit [github.com/slopus/happy-cli](https://github.com/slopus/happy-cli).
+
+## Fork Changes
+
+- Renamed package to `@zhigang1992/happy-cli` for personal npm publishing
+- Changed default server URLs to `happy-server.reily.app` and `happy.reily.app`
+- Switched from yarn to bun
+- Lazy download of tools to reduce package size (~110MB to ~186KB)
+- Added image attachment support in messages
+- Improved push notifications with folder name
+- Various bug fixes and improvements
+
+---
+
 # Happy
 
 Code on the go controlling claude code from your mobile device.
@@ -41,8 +59,8 @@ This will:
 
 ## Environment Variables
 
-- `HAPPY_SERVER_URL` - Custom server URL (default: https://api.cluster-fluster.com)
-- `HAPPY_WEBAPP_URL` - Custom web app URL (default: https://app.happy.engineering)
+- `HAPPY_SERVER_URL` - Custom server URL (default: https://happy-server.reily.app)
+- `HAPPY_WEBAPP_URL` - Custom web app URL (default: https://happy.reily.app)
 - `HAPPY_HOME_DIR` - Custom home directory for Happy data (default: ~/.happy)
 - `HAPPY_DISABLE_CAFFEINATE` - Disable macOS sleep prevention (set to `true`, `1`, or `yes`)
 - `HAPPY_EXPERIMENTAL` - Enable experimental features (set to `true`, `1`, or `yes`)

package/dist/{index-BkDVLUcE.cjs → index-DvMFDzz3.cjs}

@@ -3,7 +3,7 @@
 var chalk = require('chalk');
 var os = require('node:os');
 var node_crypto = require('node:crypto');
-var types = require('./types-Bd_EJ8VV.cjs');
+var types = require('./types-DU-KcuRq.cjs');
 var node_child_process = require('node:child_process');
 var node_path = require('node:path');
 var node_readline = require('node:readline');
@@ -22,10 +22,10 @@ require('node:events');
 require('socket.io-client');
 var tweetnacl = require('tweetnacl');
 require('expo-server-sdk');
+var os$1 = require('os');
 var crypto = require('crypto');
 var psList = require('ps-list');
 var spawn = require('cross-spawn');
-var os$1 = require('os');
 var tmp = require('tmp');
 var qrcode = require('qrcode-terminal');
 var open = require('open');
@@ -56,6 +56,7 @@ function _interopNamespaceDefault(e) {
     return Object.freeze(n);
 }
 
+var os__namespace = /*#__PURE__*/_interopNamespaceDefault(os$1);
 var tmp__namespace = /*#__PURE__*/_interopNamespaceDefault(tmp);
 var hex__namespace = /*#__PURE__*/_interopNamespaceDefault(hex);
 
@@ -1082,7 +1083,7 @@ class AbortError extends Error {
   }
 }
 
-const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BkDVLUcE.cjs', document.baseURI).href)));
+const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-DvMFDzz3.cjs', document.baseURI).href)));
 const __dirname$1 = node_path.join(__filename$1, "..");
 function getDefaultClaudeCodePath() {
   return node_path.join(__dirname$1, "..", "..", "..", "node_modules", "@anthropic-ai", "claude-code", "cli.js");
@@ -2984,10 +2985,12 @@ async function claudeRemoteLauncher(session) {
           onReady: () => {
             if (!pending && session.queue.size() === 0) {
               session.client.sendSessionEvent({ type: "ready" });
-              const folderName = path.basename(session.path);
+              const hostname = os__namespace.hostname();
+              const notificationTitle = `(${hostname}) ${session.path}`;
+              const sessionName = session.client.getSummary() || path.basename(session.path);
               session.api.push().sendToAllDevices(
-                `Ready`,
-                folderName,
+                notificationTitle,
+                sessionName,
                 { sessionId: session.client.sessionId }
               );
             }
@@ -6315,7 +6318,7 @@ ${chalk.bold("Examples:")}
 ${chalk.bold("Notes:")} 
   \u2022 You must be authenticated with Happy first (run 'happy auth login')
   \u2022 API keys are encrypted and stored securely in Happy cloud
-  \u2022 You can manage your stored keys at app.happy.engineering
+  \u2022 You can manage your stored keys at happy.reily.app
 `);
 }
 async function handleConnectVendor(vendor, displayName) {
@@ -6393,7 +6396,7 @@ async function handleConnectVendor(vendor, displayName) {
     return;
   } else if (subcommand === "codex") {
     try {
-      const { runCodex } = await Promise.resolve().then(function () { return require('./runCodex-uPJ1h0J4.cjs'); });
+      const { runCodex } = await Promise.resolve().then(function () { return require('./runCodex-B33w9tjC.cjs'); });
       let startedBy = void 0;
       for (let i = 1; i < args.length; i++) {
         if (args[i] === "--started-by") {
@@ -6438,7 +6441,7 @@ async function handleConnectVendor(vendor, displayName) {
   } else if (subcommand === "list") {
     try {
       const { credentials } = await authAndSetupMachineIfNeeded();
-      const { listSessions } = await Promise.resolve().then(function () { return require('./list-LCFlAICJ.cjs'); });
+      const { listSessions } = await Promise.resolve().then(function () { return require('./list-sCcVgML_.cjs'); });
       let sessionId;
       let titleFilter;
       let recentMsgs;
@@ -6540,7 +6543,7 @@ Examples:
         process.exit(1);
       }
       const { credentials } = await authAndSetupMachineIfNeeded();
-      const { promptSession } = await Promise.resolve().then(function () { return require('./prompt-B0ezty5F.cjs'); });
+      const { promptSession } = await Promise.resolve().then(function () { return require('./prompt-DQyb25aY.cjs'); });
       await promptSession(credentials, sessionId, promptText, timeoutMinutes ?? void 0);
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");

package/dist/{index-h3SrsKqR.mjs → index-iFxcl7Hn.mjs}

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import os$1, { homedir } from 'node:os';
 import { randomUUID, randomBytes, createHmac } from 'node:crypto';
-import { l as logger, p as projectPath, j as backoff, k as delay, R as RawJSONLinesSchema, m as AsyncLock, c as configuration, n as readDaemonState, o as clearDaemonState, i as packageJson, r as readSettings, q as readCredentials, g as encodeBase64, u as updateSettings, s as encodeBase64Url, d as decodeBase64, w as writeCredentialsLegacy, t as writeCredentialsDataKey, v as acquireDaemonLock, x as writeDaemonState, A as ApiClient, y as releaseDaemonLock, z as authChallenge, B as clearCredentials, C as clearMachineId, D as getLatestDaemonLog } from './types-Cn6qSxMP.mjs';
+import { l as logger, p as projectPath, j as backoff, k as delay, R as RawJSONLinesSchema, m as AsyncLock, c as configuration, n as readDaemonState, o as clearDaemonState, i as packageJson, r as readSettings, q as readCredentials, g as encodeBase64, u as updateSettings, s as encodeBase64Url, d as decodeBase64, w as writeCredentialsLegacy, t as writeCredentialsDataKey, v as acquireDaemonLock, x as writeDaemonState, A as ApiClient, y as releaseDaemonLock, z as authChallenge, B as clearCredentials, C as clearMachineId, D as getLatestDaemonLog } from './types-BQ_WM2tI.mjs';
 import { spawn, execSync, execFileSync } from 'node:child_process';
 import { resolve, join } from 'node:path';
 import { createInterface } from 'node:readline';
@@ -20,10 +20,11 @@ import 'node:events';
 import 'socket.io-client';
 import tweetnacl from 'tweetnacl';
 import 'expo-server-sdk';
+import * as os from 'os';
+import os__default from 'os';
 import { createHash, randomBytes as randomBytes$1 } from 'crypto';
 import psList from 'ps-list';
 import spawn$2 from 'cross-spawn';
-import os from 'os';
 import * as tmp from 'tmp';
 import qrcode from 'qrcode-terminal';
 import open from 'open';
@@ -2961,10 +2962,12 @@ async function claudeRemoteLauncher(session) {
           onReady: () => {
             if (!pending && session.queue.size() === 0) {
               session.client.sendSessionEvent({ type: "ready" });
-              const folderName = basename(session.path);
+              const hostname = os.hostname();
+              const notificationTitle = `(${hostname}) ${session.path}`;
+              const sessionName = session.client.getSummary() || basename(session.path);
               session.api.push().sendToAllDevices(
-                `Ready`,
-                folderName,
+                notificationTitle,
+                sessionName,
                 { sessionId: session.client.sessionId }
               );
             }
@@ -4468,10 +4471,10 @@ function startDaemonControlServer({
 }
 
 const initialMachineMetadata = {
-  host: os.hostname(),
-  platform: os.platform(),
+  host: os__default.hostname(),
+  platform: os__default.platform(),
   happyCliVersion: packageJson.version,
-  homeDir: os.homedir(),
+  homeDir: os__default.homedir(),
   happyHomeDir: configuration.happyHomeDir,
   happyLibDir: projectPath()
 };
@@ -5306,10 +5309,10 @@ async function install$1() {
                 <true/>
                 
                 <key>StandardErrorPath</key>
-                <string>${os.homedir()}/.happy/daemon.err</string>
+                <string>${os__default.homedir()}/.happy/daemon.err</string>
                 
                 <key>StandardOutPath</key>
-                <string>${os.homedir()}/.happy/daemon.log</string>
+                <string>${os__default.homedir()}/.happy/daemon.log</string>
                 
                 <key>WorkingDirectory</key>
                 <string>/tmp</string>
@@ -6292,7 +6295,7 @@ ${chalk.bold("Examples:")}
 ${chalk.bold("Notes:")} 
   \u2022 You must be authenticated with Happy first (run 'happy auth login')
   \u2022 API keys are encrypted and stored securely in Happy cloud
-  \u2022 You can manage your stored keys at app.happy.engineering
+  \u2022 You can manage your stored keys at happy.reily.app
 `);
 }
 async function handleConnectVendor(vendor, displayName) {
@@ -6370,7 +6373,7 @@ async function handleConnectVendor(vendor, displayName) {
     return;
   } else if (subcommand === "codex") {
     try {
-      const { runCodex } = await import('./runCodex-BarDBoPV.mjs');
+      const { runCodex } = await import('./runCodex-BeLLGX3X.mjs');
       let startedBy = void 0;
       for (let i = 1; i < args.length; i++) {
         if (args[i] === "--started-by") {
@@ -6415,7 +6418,7 @@ async function handleConnectVendor(vendor, displayName) {
   } else if (subcommand === "list") {
     try {
       const { credentials } = await authAndSetupMachineIfNeeded();
-      const { listSessions } = await import('./list-BJBPeYMn.mjs');
+      const { listSessions } = await import('./list-DqbAuRvF.mjs');
       let sessionId;
       let titleFilter;
       let recentMsgs;
@@ -6517,7 +6520,7 @@ Examples:
         process.exit(1);
       }
       const { credentials } = await authAndSetupMachineIfNeeded();
-      const { promptSession } = await import('./prompt-B35fwI-i.mjs');
+      const { promptSession } = await import('./prompt-DwjhpAf5.mjs');
       await promptSession(credentials, sessionId, promptText, timeoutMinutes ?? void 0);
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 require('chalk');
-require('./index-BkDVLUcE.cjs');
-require('./types-Bd_EJ8VV.cjs');
+require('./index-DvMFDzz3.cjs');
+require('./types-DU-KcuRq.cjs');
 require('zod');
 require('node:child_process');
 require('node:os');
@@ -24,10 +24,10 @@ require('node:events');
 require('socket.io-client');
 require('tweetnacl');
 require('expo-server-sdk');
+require('os');
 require('crypto');
 require('ps-list');
 require('cross-spawn');
-require('os');
 require('tmp');
 require('qrcode-terminal');
 require('open');

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import 'chalk';
-import './index-h3SrsKqR.mjs';
-import './types-Cn6qSxMP.mjs';
+import './index-iFxcl7Hn.mjs';
+import './types-BQ_WM2tI.mjs';
 import 'zod';
 import 'node:child_process';
 import 'node:os';
@@ -22,10 +22,10 @@ import 'node:events';
 import 'socket.io-client';
 import 'tweetnacl';
 import 'expo-server-sdk';
+import 'os';
 import 'crypto';
 import 'ps-list';
 import 'cross-spawn';
-import 'os';
 import 'tmp';
 import 'qrcode-terminal';
 import 'open';

package/dist/lib.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var types = require('./types-Bd_EJ8VV.cjs');
+var types = require('./types-DU-KcuRq.cjs');
 require('axios');
 require('chalk');
 require('fs');

package/dist/lib.d.cts

@@ -430,6 +430,11 @@ declare class ApiSessionClient extends EventEmitter {
      * Send usage data to the server
      */
     sendUsageData(usage: Usage): void;
+    /**
+     * Get the current session summary/title
+     * @returns The summary text or undefined if not set
+     */
+    getSummary(): string | undefined;
     /**
      * Update session metadata
      * @param handler - Handler function that returns the updated metadata

package/dist/lib.d.mts

@@ -430,6 +430,11 @@ declare class ApiSessionClient extends EventEmitter {
      * Send usage data to the server
      */
     sendUsageData(usage: Usage): void;
+    /**
+     * Get the current session summary/title
+     * @returns The summary text or undefined if not set
+     */
+    getSummary(): string | undefined;
     /**
      * Update session metadata
      * @param handler - Handler function that returns the updated metadata

package/dist/lib.mjs

@@ -1,4 +1,4 @@
-export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-Cn6qSxMP.mjs';
+export { A as ApiClient, a as ApiSessionClient, R as RawJSONLinesSchema, c as configuration, l as logger } from './types-BQ_WM2tI.mjs';
 import 'axios';
 import 'chalk';
 import 'fs';

package/dist/{list-BJBPeYMn.mjs → list-DqbAuRvF.mjs}

@@ -1,4 +1,4 @@
-import { c as configuration, l as logger, d as decodeBase64, b as decrypt, f as formatTimeAgo, e as libsodiumDecryptFromPublicKey } from './types-Cn6qSxMP.mjs';
+import { c as configuration, l as logger, d as decodeBase64, b as decrypt, f as formatTimeAgo, e as libsodiumDecryptFromPublicKey } from './types-BQ_WM2tI.mjs';
 import axios from 'axios';
 import { existsSync, readdirSync, statSync, readFileSync } from 'fs';
 import { join } from 'path';

package/dist/{list-LCFlAICJ.cjs → list-sCcVgML_.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var types = require('./types-Bd_EJ8VV.cjs');
+var types = require('./types-DU-KcuRq.cjs');
 var axios = require('axios');
 var fs = require('fs');
 var path = require('path');

package/dist/{prompt-B0ezty5F.cjs → prompt-DQyb25aY.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var types = require('./types-Bd_EJ8VV.cjs');
+var types = require('./types-DU-KcuRq.cjs');
 var axios = require('axios');
 var socket_ioClient = require('socket.io-client');
 require('chalk');

package/dist/{prompt-B35fwI-i.mjs → prompt-DwjhpAf5.mjs}

@@ -1,4 +1,4 @@
-import { c as configuration, b as decrypt, d as decodeBase64, l as logger, g as encodeBase64, h as encrypt } from './types-Cn6qSxMP.mjs';
+import { c as configuration, b as decrypt, d as decodeBase64, l as logger, g as encodeBase64, h as encrypt } from './types-BQ_WM2tI.mjs';
 import axios from 'axios';
 import { io } from 'socket.io-client';
 import 'chalk';

package/dist/{runCodex-uPJ1h0J4.cjs → runCodex-B33w9tjC.cjs}

@@ -2,14 +2,14 @@
 
 var ink = require('ink');
 var React = require('react');
-var types = require('./types-Bd_EJ8VV.cjs');
+var types = require('./types-DU-KcuRq.cjs');
 var index_js = require('@modelcontextprotocol/sdk/client/index.js');
 var stdio_js = require('@modelcontextprotocol/sdk/client/stdio.js');
 var z = require('zod');
 var types_js = require('@modelcontextprotocol/sdk/types.js');
 var child_process = require('child_process');
 var node_crypto = require('node:crypto');
-var index = require('./index-BkDVLUcE.cjs');
+var index = require('./index-DvMFDzz3.cjs');
 var os = require('node:os');
 var node_path = require('node:path');
 var fs = require('node:fs');
@@ -30,9 +30,9 @@ require('expo-server-sdk');
 require('node:child_process');
 require('node:readline');
 require('node:url');
+require('os');
 require('ps-list');
 require('cross-spawn');
-require('os');
 require('tmp');
 require('qrcode-terminal');
 require('open');
@@ -876,8 +876,10 @@ async function runCodex(opts) {
   const sendReady = () => {
     session.sendSessionEvent({ type: "ready" });
     try {
+      const hostname = os.hostname();
+      const notificationTitle = `(${hostname}) ${process.cwd()}`;
       api.push().sendToAllDevices(
-        "It's ready!",
+        notificationTitle,
         "Codex is waiting for your command",
         { sessionId: session.sessionId }
       );

package/dist/{runCodex-BarDBoPV.mjs → runCodex-BeLLGX3X.mjs}

@@ -1,13 +1,13 @@
 import { useStdout, useInput, Box, Text, render } from 'ink';
 import React, { useState, useRef, useEffect, useCallback } from 'react';
-import { l as logger, A as ApiClient, r as readSettings, p as projectPath, c as configuration, i as packageJson } from './types-Cn6qSxMP.mjs';
+import { l as logger, A as ApiClient, r as readSettings, p as projectPath, c as configuration, i as packageJson } from './types-BQ_WM2tI.mjs';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { z } from 'zod';
 import { ElicitRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { execSync } from 'child_process';
 import { randomUUID } from 'node:crypto';
-import { i as initialMachineMetadata, n as notifyDaemonSessionStarted, M as MessageQueue2, h as hashObject, r as registerKillSessionHandler, a as MessageBuffer, s as startHappyServer, t as trimIdent, b as stopCaffeinate } from './index-h3SrsKqR.mjs';
+import { i as initialMachineMetadata, n as notifyDaemonSessionStarted, M as MessageQueue2, h as hashObject, r as registerKillSessionHandler, a as MessageBuffer, s as startHappyServer, t as trimIdent, b as stopCaffeinate } from './index-iFxcl7Hn.mjs';
 import os from 'node:os';
 import { resolve, join } from 'node:path';
 import fs from 'node:fs';
@@ -28,9 +28,9 @@ import 'expo-server-sdk';
 import 'node:child_process';
 import 'node:readline';
 import 'node:url';
+import 'os';
 import 'ps-list';
 import 'cross-spawn';
-import 'os';
 import 'tmp';
 import 'qrcode-terminal';
 import 'open';
@@ -874,8 +874,10 @@ async function runCodex(opts) {
   const sendReady = () => {
     session.sendSessionEvent({ type: "ready" });
     try {
+      const hostname = os.hostname();
+      const notificationTitle = `(${hostname}) ${process.cwd()}`;
       api.push().sendToAllDevices(
-        "It's ready!",
+        notificationTitle,
         "Codex is waiting for your command",
         { sessionId: session.sessionId }
       );

package/dist/{types-Cn6qSxMP.mjs → types-BQ_WM2tI.mjs}

@@ -20,7 +20,7 @@ import { fileURLToPath } from 'url';
 import { Expo } from 'expo-server-sdk';
 
 var name = "@zhigang1992/happy-cli";
-var version = "0.12.6";
+var version = "0.12.9";
 var description = "Mobile and Web client for Claude Code and Codex";
 var author = "Kirill Dubovitskiy";
 var license = "MIT";
@@ -181,8 +181,8 @@ class Configuration {
   isExperimentalEnabled;
   disableCaffeinate;
   constructor() {
-    this.serverUrl = process.env.HAPPY_SERVER_URL || "https://api.cluster-fluster.com";
-    this.webappUrl = process.env.HAPPY_WEBAPP_URL || "https://app.happy.engineering";
+    this.serverUrl = process.env.HAPPY_SERVER_URL || "https://happy-server.reily.app";
+    this.webappUrl = process.env.HAPPY_WEBAPP_URL || "https://happy.reily.app";
     const args = process.argv.slice(2);
     this.isDaemonProcess = args.length >= 2 && args[0] === "daemon" && args[1] === "start-sync";
     if (process.env.HAPPY_HOME_DIR) {
@@ -1697,6 +1697,13 @@ class ApiSessionClient extends EventEmitter {
     logger.debugLargeJson("[SOCKET] Sending usage data:", usageReport);
     this.socket.emit("usage-report", usageReport);
   }
+  /**
+   * Get the current session summary/title
+   * @returns The summary text or undefined if not set
+   */
+  getSummary() {
+    return this.metadata?.summary?.text;
+  }
   /**
    * Update session metadata
    * @param handler - Handler function that returns the updated metadata

package/dist/{types-Bd_EJ8VV.cjs → types-DU-KcuRq.cjs}

@@ -41,7 +41,7 @@ function _interopNamespaceDefault(e) {
 var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
 
 var name = "@zhigang1992/happy-cli";
-var version = "0.12.6";
+var version = "0.12.9";
 var description = "Mobile and Web client for Claude Code and Codex";
 var author = "Kirill Dubovitskiy";
 var license = "MIT";
@@ -202,8 +202,8 @@ class Configuration {
   isExperimentalEnabled;
   disableCaffeinate;
   constructor() {
-    this.serverUrl = process.env.HAPPY_SERVER_URL || "https://api.cluster-fluster.com";
-    this.webappUrl = process.env.HAPPY_WEBAPP_URL || "https://app.happy.engineering";
+    this.serverUrl = process.env.HAPPY_SERVER_URL || "https://happy-server.reily.app";
+    this.webappUrl = process.env.HAPPY_WEBAPP_URL || "https://happy.reily.app";
     const args = process.argv.slice(2);
     this.isDaemonProcess = args.length >= 2 && args[0] === "daemon" && args[1] === "start-sync";
     if (process.env.HAPPY_HOME_DIR) {
@@ -1150,7 +1150,7 @@ class RpcHandlerManager {
   }
 }
 
-const __dirname$1 = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-Bd_EJ8VV.cjs', document.baseURI).href))));
+const __dirname$1 = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-DU-KcuRq.cjs', document.baseURI).href))));
 function projectPath() {
   const path$1 = path.resolve(__dirname$1, "..");
   return path$1;
@@ -1718,6 +1718,13 @@ class ApiSessionClient extends node_events.EventEmitter {
     logger.debugLargeJson("[SOCKET] Sending usage data:", usageReport);
     this.socket.emit("usage-report", usageReport);
   }
+  /**
+   * Get the current session summary/title
+   * @returns The summary text or undefined if not set
+   */
+  getSummary() {
+    return this.metadata?.summary?.text;
+  }
   /**
    * Update session metadata
    * @param handler - Handler function that returns the updated metadata

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhigang1992/happy-cli",
-  "version": "0.12.6",
+  "version": "0.12.9",
   "description": "Mobile and Web client for Claude Code and Codex",
   "author": "Kirill Dubovitskiy",
   "license": "MIT",