@zhigang1992/happy-cli 0.12.1

package/README.md

@@ -0,0 +1,60 @@
+# Happy
+
+Code on the go controlling claude code from your mobile device.
+
+Free. Open source. Code anywhere.
+
+## Installation
+
+```bash
+npm install -g happy-coder
+```
+
+## Usage
+
+```bash
+happy
+```
+
+This will:
+1. Start a Claude Code session
+2. Display a QR code to connect from your mobile device
+3. Allow real-time session sharing between Claude Code and your mobile app
+
+## Commands
+
+- `happy auth` – Manage authentication
+- `happy codex` – Start Codex mode
+- `happy connect` – Store AI vendor API keys in Happy cloud
+- `happy notify` – Send a push notification to your devices
+- `happy daemon` – Manage background service
+- `happy doctor` – System diagnostics & troubleshooting
+
+## Options
+
+- `-h, --help` - Show help
+- `-v, --version` - Show version
+- `-m, --model <model>` - Claude model to use (default: sonnet)
+- `-p, --permission-mode <mode>` - Permission mode: auto, default, or plan
+- `--claude-env KEY=VALUE` - Set environment variable for Claude Code
+- `--claude-arg ARG` - Pass additional argument to Claude CLI
+
+## 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_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`)
+
+## Requirements
+
+- Node.js >= 20.0.0
+  - Required by `eventsource-parser@3.0.5`, which is required by
+  `@modelcontextprotocol/sdk`, which we used to implement permission forwarding
+  to mobile app
+- Claude CLI installed & logged in (`claude` command available in PATH)
+
+## License
+
+MIT

package/bin/happy-mcp.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+import { execFileSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+
+// Ensure Node flags to reduce noisy warnings on stdout (which could interfere with MCP)
+const hasNoWarnings = process.execArgv.includes('--no-warnings');
+const hasNoDeprecation = process.execArgv.includes('--no-deprecation');
+
+if (!hasNoWarnings || !hasNoDeprecation) {
+  const projectRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+  const entrypoint = join(projectRoot, 'dist', 'codex', 'happyMcpStdioBridge.mjs');
+
+  try {
+    execFileSync(process.execPath, [
+      '--no-warnings',
+      '--no-deprecation',
+      entrypoint,
+      ...process.argv.slice(2)
+    ], {
+      stdio: 'inherit',
+      env: process.env
+    });
+  } catch (error) {
+    process.exit(error.status || 1);
+  }
+} else {
+  // Already have desired flags; import module directly
+  import('../dist/codex/happyMcpStdioBridge.mjs');
+}
+

package/bin/happy.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+import { execFileSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+
+// Check if we're already running with the flags
+const hasNoWarnings = process.execArgv.includes('--no-warnings');
+const hasNoDeprecation = process.execArgv.includes('--no-deprecation');
+
+if (!hasNoWarnings || !hasNoDeprecation) {
+  // Get path to the actual CLI entrypoint
+  const projectRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+  const entrypoint = join(projectRoot, 'dist', 'index.mjs');
+  
+  // Execute the actual CLI directly with the correct flags
+  try {
+    execFileSync(process.execPath, [
+      '--no-warnings',
+      '--no-deprecation',
+      entrypoint,
+      ...process.argv.slice(2)
+    ], {
+      stdio: 'inherit',
+      env: process.env
+    });
+  } catch (error) {
+    // execFileSync throws if the process exits with non-zero
+    process.exit(error.status || 1);
+  }
+} else {
+  // We're running Node with the flags we wanted, import the CLI entrypoint
+  // module to avoid creating a new process.
+  import("../dist/index.mjs");
+}

package/dist/codex/happyMcpStdioBridge.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
+var stdio_js = require('@modelcontextprotocol/sdk/server/stdio.js');
+var index_js = require('@modelcontextprotocol/sdk/client/index.js');
+var streamableHttp_js = require('@modelcontextprotocol/sdk/client/streamableHttp.js');
+var z = require('zod');
+
+function parseArgs(argv) {
+  let url = null;
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--url" && i + 1 < argv.length) {
+      url = argv[i + 1];
+      i++;
+    }
+  }
+  return { url };
+}
+async function main() {
+  const { url: urlFromArgs } = parseArgs(process.argv.slice(2));
+  const baseUrl = urlFromArgs || process.env.HAPPY_HTTP_MCP_URL || "";
+  if (!baseUrl) {
+    process.stderr.write(
+      "[happy-mcp] Missing target URL. Set HAPPY_HTTP_MCP_URL or pass --url <http://127.0.0.1:PORT>\n"
+    );
+    process.exit(2);
+  }
+  let httpClient = null;
+  async function ensureHttpClient() {
+    if (httpClient) return httpClient;
+    const client = new index_js.Client(
+      { name: "happy-stdio-bridge", version: "1.0.0" },
+      { capabilities: { tools: {} } }
+    );
+    const transport = new streamableHttp_js.StreamableHTTPClientTransport(new URL(baseUrl));
+    await client.connect(transport);
+    httpClient = client;
+    return client;
+  }
+  const server = new mcp_js.McpServer({
+    name: "Happy MCP Bridge",
+    version: "1.0.0",
+    description: "STDIO bridge forwarding to Happy HTTP MCP"
+  });
+  server.registerTool(
+    "change_title",
+    {
+      description: "Change the title of the current chat session",
+      title: "Change Chat Title",
+      inputSchema: {
+        title: z.z.string().describe("The new title for the chat session")
+      }
+    },
+    async (args) => {
+      try {
+        const client = await ensureHttpClient();
+        const response = await client.callTool({ name: "change_title", arguments: args });
+        return response;
+      } catch (error) {
+        return {
+          content: [
+            { type: "text", text: `Failed to change chat title: ${error instanceof Error ? error.message : String(error)}` }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  const stdio = new stdio_js.StdioServerTransport();
+  await server.connect(stdio);
+}
+main().catch((err) => {
+  try {
+    process.stderr.write(`[happy-mcp] Fatal: ${err instanceof Error ? err.message : String(err)}
+`);
+  } finally {
+    process.exit(1);
+  }
+});

package/dist/codex/happyMcpStdioBridge.d.cts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/codex/happyMcpStdioBridge.d.mts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/codex/happyMcpStdioBridge.mjs

@@ -0,0 +1,78 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { z } from 'zod';
+
+function parseArgs(argv) {
+  let url = null;
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--url" && i + 1 < argv.length) {
+      url = argv[i + 1];
+      i++;
+    }
+  }
+  return { url };
+}
+async function main() {
+  const { url: urlFromArgs } = parseArgs(process.argv.slice(2));
+  const baseUrl = urlFromArgs || process.env.HAPPY_HTTP_MCP_URL || "";
+  if (!baseUrl) {
+    process.stderr.write(
+      "[happy-mcp] Missing target URL. Set HAPPY_HTTP_MCP_URL or pass --url <http://127.0.0.1:PORT>\n"
+    );
+    process.exit(2);
+  }
+  let httpClient = null;
+  async function ensureHttpClient() {
+    if (httpClient) return httpClient;
+    const client = new Client(
+      { name: "happy-stdio-bridge", version: "1.0.0" },
+      { capabilities: { tools: {} } }
+    );
+    const transport = new StreamableHTTPClientTransport(new URL(baseUrl));
+    await client.connect(transport);
+    httpClient = client;
+    return client;
+  }
+  const server = new McpServer({
+    name: "Happy MCP Bridge",
+    version: "1.0.0",
+    description: "STDIO bridge forwarding to Happy HTTP MCP"
+  });
+  server.registerTool(
+    "change_title",
+    {
+      description: "Change the title of the current chat session",
+      title: "Change Chat Title",
+      inputSchema: {
+        title: z.string().describe("The new title for the chat session")
+      }
+    },
+    async (args) => {
+      try {
+        const client = await ensureHttpClient();
+        const response = await client.callTool({ name: "change_title", arguments: args });
+        return response;
+      } catch (error) {
+        return {
+          content: [
+            { type: "text", text: `Failed to change chat title: ${error instanceof Error ? error.message : String(error)}` }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  const stdio = new StdioServerTransport();
+  await server.connect(stdio);
+}
+main().catch((err) => {
+  try {
+    process.stderr.write(`[happy-mcp] Fatal: ${err instanceof Error ? err.message : String(err)}
+`);
+  } finally {
+    process.exit(1);
+  }
+});