@cerulin/chell 0.2.5

package/README.md

@@ -0,0 +1,75 @@
+# Chell (aka Happy)
+
+Code on the go controlling claude code from your mobile device.
+
+Free. Open source. Code anywhere. test
+
+## Installation
+
+```bash
+# From npm registry (once installed globally, the `chell` command is available)
+npm install -g happy-coder
+
+# Or install this local checkout (from the repo root)
+npm install -g .
+
+# Alternatively, link for active development
+npm link
+```
+
+## Usage
+
+```bash
+chell
+```
+
+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
+
+## 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
+
+## Command names
+
+- Preferred: `chell` (new)
+- Backwards compatible alias: `happy` (still available)
+
+For MCP bridge usage, you can also invoke:
+
+```bash
+chell-mcp
+```
+
+This is identical to the legacy `happy-mcp` entry point.
+
+## 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)
+
+## Developing locally
+
+If you want to run without a global install during development on Windows/macOS/Linux:
+
+```bash
+yarn dev            # runs the TypeScript entrypoint with tsx
+# or
+yarn build && node bin/chell.mjs  # starts the built CLI
+```
+
+Note: on Windows, execute with `node bin/chell.mjs` instead of running the script directly.
+
+## License
+
+MIT

package/bin/chell-mcp.mjs

@@ -0,0 +1,33 @@
+#!/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', 'chellMcpStdioBridge.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/chellMcpStdioBridge.mjs');
+}
+
+

package/bin/chell.mjs

@@ -0,0 +1,37 @@
+#!/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/chellMcpStdioBridge.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.CHELL_HTTP_MCP_URL || "";
+  if (!baseUrl) {
+    process.stderr.write(
+      "[chell-mcp] Missing target URL. Set CHELL_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: "chell-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: "Chell MCP Bridge",
+    version: "1.0.0",
+    description: "STDIO bridge forwarding to Chell 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(`[chell-mcp] Fatal: ${err instanceof Error ? err.message : String(err)}
+`);
+  } finally {
+    process.exit(1);
+  }
+});

package/dist/codex/chellMcpStdioBridge.d.cts

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

package/dist/codex/chellMcpStdioBridge.d.mts

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

package/dist/codex/chellMcpStdioBridge.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.CHELL_HTTP_MCP_URL || "";
+  if (!baseUrl) {
+    process.stderr.write(
+      "[chell-mcp] Missing target URL. Set CHELL_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: "chell-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: "Chell MCP Bridge",
+    version: "1.0.0",
+    description: "STDIO bridge forwarding to Chell 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(`[chell-mcp] Fatal: ${err instanceof Error ? err.message : String(err)}
+`);
+  } finally {
+    process.exit(1);
+  }
+});