baychat 0.27.0 → 0.27.1

package/README.md

@@ -113,7 +113,7 @@ Updating npm alone does not refresh a skill already loaded in a running session.
 
 **No Monitor deadline with the channel.** `baychat connect claude` also registers
 `baychat_channel`, a local Claude Code channel. Start Claude Code with
-`baychat start` (or `claude --dangerously-load-development-channels server:baychat_channel`)
+`baychat claude` (or `baychat start`, which uses tmux when installed)
 and the skill calls its `listen` tool instead of opening a Monitor: the channel holds the
 feed, reconnects by itself, and wakes the session only when a message arrives. Started
 without the flag, `listen` answers `inactive` and the Monitor path above is used.

package/dist/channel/detect.js

@@ -47,12 +47,19 @@ exports.detectChannel = detectChannel;
  * replaced. So `listen` answers active only on evidence, and otherwise sends the session back
  * to `listen_messages` + Monitor.
  *
- * The evidence is the command line Claude Code itself was started with: an ancestor process
- * whose arguments carry `--dangerously-load-development-channels` or `--channels` naming
- * `server:baychat_channel`. Claude Code spawns this server directly, so it is the parent; a few
- * more levels are walked for launchers that wrap it. Where process arguments cannot be read
- * (Windows), `BAYCHAT_CHANNEL=1` — set by `baychat start` on the process it launches with the
- * flag — is accepted instead.
+ * Two kinds of evidence, either enough:
+ *
+ *  1. `BAYCHAT_CHANNEL=1` in this process's environment. `baychat claude` and `baychat start` set
+ *     it on the Claude Code they launch WITH the flag, and Claude Code passes its environment to
+ *     the servers it spawns (checked on 2.1.284). Set per launch, never exported, so a plain
+ *     `claude` does not inherit it.
+ *  2. The flag on an ancestor's command line: `--dangerously-load-development-channels` or
+ *     `--channels` naming `server:baychat_channel`, for people who type the flag themselves.
+ *     NOT reliable on its own: Claude Code sets `process.title = "claude"` at start, and where it
+ *     runs on Node (an npm install, e.g. under nvm on WSL) that overwrites /proc/<pid>/cmdline,
+ *     so the flags vanish. Found 2026-10-02 on the owner's WSL: launched with the flag, `ps`
+ *     showed only `claude`, and `listen` wrongly answered inactive. A wrong "inactive" is safe —
+ *     the session falls back to a Monitor — but it is why (1) exists.
  */
 const node_child_process_1 = require("node:child_process");
 const fs = __importStar(require("node:fs"));
@@ -121,25 +128,18 @@ function realProcessReader(platform = process.platform) {
 }
 /** Look for the flag on this process's ancestors, then fall back to the env marker. */
 function detectChannel(opts = {}) {
-    const read = opts.read ?? realProcessReader();
     const env = opts.env ?? process.env;
+    if (env.BAYCHAT_CHANNEL === "1")
+        return { active: true, how: "env" };
+    const read = opts.read ?? realProcessReader();
     let pid = opts.pid ?? process.ppid;
-    let readable = false;
     for (let depth = 0; depth < MAX_DEPTH && pid > 1; depth++) {
         const info = read(pid);
         if (!info)
             break;
-        if (info.args) {
-            readable = true;
-            if (argsEnableChannel(info.args))
-                return { active: true, how: "process" };
-        }
+        if (info.args && argsEnableChannel(info.args))
+            return { active: true, how: "process" };
         pid = info.ppid;
     }
-    // Only where nothing could be read: a readable tree without the flag is a real "no", and an
-    // inherited marker must not overrule it (a plain `claude` started inside a `baychat start`
-    // terminal would carry the marker without the flag).
-    if (!readable && env.BAYCHAT_CHANNEL === "1")
-        return { active: true, how: "env" };
     return { active: false, how: "none" };
 }

package/dist/channel/launch.js

@@ -33,9 +33,11 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHANNEL_LAUNCH_COMMAND = exports.CHANNEL_LAUNCH_ARGS = exports.CHANNEL_MIN_CLAUDE = void 0;
+exports.CHANNEL_ENV = exports.CHANNEL_LAUNCH_COMMAND = exports.CHANNEL_LAUNCH_ARGS = exports.CHANNEL_MIN_CLAUDE = void 0;
 exports.parseClaudeVersion = parseClaudeVersion;
 exports.claudeSupportsChannel = claudeSupportsChannel;
+exports.channelLaunchFor = channelLaunchFor;
+exports.cmdClaude = cmdClaude;
 exports.claudeChannelAddArgs = claudeChannelAddArgs;
 exports.registerChannelWithClaude = registerChannelWithClaude;
 exports.claudeUserConfigPath = claudeUserConfigPath;
@@ -47,9 +49,11 @@ exports.channelRegistered = channelRegistered;
  * AND each session must be started with the channel flag — being in the MCP config is not enough
  * for a channel to deliver anything (docs: "a server also has to be named in --channels").
  */
+const node_child_process_1 = require("node:child_process");
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
+const runtime_binary_1 = require("../runtime-binary");
 const detect_1 = require("./detect");
 /**
  * The first Claude Code this is switched on for. Channels exist from earlier releases, but
@@ -76,7 +80,51 @@ function claudeSupportsChannel(version) {
 /** The arguments `baychat start` adds to a Claude Code launch. */
 exports.CHANNEL_LAUNCH_ARGS = [detect_1.DEV_CHANNELS_FLAG, detect_1.CHANNEL_FLAG_VALUE];
 /** What to type to start Claude Code with the channel on. */
-exports.CHANNEL_LAUNCH_COMMAND = `claude ${exports.CHANNEL_LAUNCH_ARGS.join(" ")}`;
+exports.CHANNEL_LAUNCH_COMMAND = "baychat claude";
+/**
+ * The marker the channel trusts (detect.ts). Set on the ONE process launched, never exported:
+ * Claude Code can hide its own flags, so the launcher vouches for them instead.
+ */
+exports.CHANNEL_ENV = { BAYCHAT_CHANNEL: "1" };
+/**
+ * Decide for one Claude Code binary. Plain (and the session uses a Monitor) when the channel
+ * server is not registered or this Claude Code is too old for the flag — an unknown flag would
+ * stop it from starting at all.
+ */
+function channelLaunchFor(claudePath, deps = {}) {
+    const registered = deps.registered ?? (() => channelRegistered());
+    if (!registered())
+        return { on: false, args: [], env: {}, why: "the BayChat channel is not set up here (run `baychat connect claude`)" };
+    const text = (deps.version ?? probeVersion)(claudePath);
+    if (!claudeSupportsChannel(text ? parseClaudeVersion(text) : undefined)) {
+        return { on: false, args: [], env: {}, why: `Claude Code ${exports.CHANNEL_MIN_CLAUDE.join(".")} or newer is needed for the channel (run \`claude update\`)` };
+    }
+    return { on: true, args: [...exports.CHANNEL_LAUNCH_ARGS], env: { ...exports.CHANNEL_ENV } };
+}
+function probeVersion(claudePath) {
+    const probe = (0, node_child_process_1.spawnSync)(claudePath, ["--version"], { encoding: "utf8", timeout: 10_000 });
+    return probe.error || probe.status !== 0 ? undefined : String(probe.stdout ?? "");
+}
+/**
+ * `baychat claude [args…]` — Claude Code with the BayChat channel switched on, in this terminal.
+ * No multiplexer (that is `baychat start`), nothing else changed: every argument is passed on.
+ */
+function cmdClaude(args) {
+    const binary = (0, runtime_binary_1.resolveRuntimeBinary)("claude", (0, runtime_binary_1.currentBinaryEnv)());
+    if (!binary.ok) {
+        console.error(`Could not start Claude Code: ${binary.reason}`);
+        return 1;
+    }
+    const launch = channelLaunchFor(binary.path);
+    if (!launch.on)
+        console.error(`Starting Claude Code without the BayChat channel: ${launch.why}. Messages will use the Monitor.`);
+    const result = (0, node_child_process_1.spawnSync)(binary.path, [...launch.args, ...args], { stdio: "inherit", env: { ...process.env, ...launch.env } });
+    if (result.error) {
+        console.error(`Could not start Claude Code: ${result.error.message}`);
+        return 1;
+    }
+    return result.status ?? 0;
+}
 /** `claude mcp add` argv for the channel server: this CLI by absolute path, run as `channel`. */
 function claudeChannelAddArgs(launch) {
     return ["mcp", "add", "--scope", "user", detect_1.CHANNEL_MCP_ENTRY, "--", launch.node, launch.entry, "channel"];

package/dist/channel/server.js

@@ -180,7 +180,8 @@ class ChannelService {
         if (!evidence.active) {
             return toolResult("inactive", `Inactive: this Claude Code session was not started with the BayChat channel, so its events would be ` +
                 `dropped. Use listen_messages and a native Monitor for session "${session}" as usual. To use the channel ` +
-                `next time, start Claude Code with \`baychat start\`, or \`claude ${detect_1.DEV_CHANNELS_FLAG} ${detect_1.CHANNEL_FLAG_VALUE}\`.`, { session });
+                `next time, start Claude Code with \`baychat claude\` (or \`baychat start\`) — the plain \`claude ${detect_1.DEV_CHANNELS_FLAG} ${detect_1.CHANNEL_FLAG_VALUE}\` ` +
+                `works too, except where Claude Code hides its own flags (an npm/Node install).`, { session });
         }
         let bayName;
         try {

package/dist/connect-claude.js

@@ -77,8 +77,7 @@ function registerChannel() {
 function reportChannel(result) {
     if (result === "registered") {
         console.log("✓ BayChat channel added to Claude Code (wakes a session with no Monitor deadline)");
-        console.log("  Start sessions with `baychat start`, or type:");
-        console.log(`    ${launch_1.CHANNEL_LAUNCH_COMMAND}`);
+        console.log(`  Start Claude Code with \`${launch_1.CHANNEL_LAUNCH_COMMAND}\` (or \`baychat start\`) to use it.`);
         console.log("  Without it, incoming messages use the native WebSocket Monitor as before.");
         return;
     }

package/dist/main.js

@@ -16,6 +16,7 @@ const connect_plan_1 = require("./connect-plan");
 const runtimes_1 = require("./runtimes");
 const mcp_1 = require("./mcp");
 const server_1 = require("./channel/server");
+const launch_1 = require("./channel/launch");
 const mcp_config_1 = require("./mcp-config");
 const commands_2 = require("./relay/commands");
 const bays_1 = require("./bays");
@@ -473,6 +474,10 @@ async function main() {
             (0, mcp_config_1.cmdMcpConfig)(args.includes("--client") ? ((0, args_1.flag)(args, "--client") ?? "") : undefined);
             return 0;
         }
+        case "claude":
+            // Claude Code with the BayChat channel on (docs/features/CLAUDE_CODE_CHANNEL.md). Every
+            // argument after `claude` is Claude Code's own.
+            return (0, launch_1.cmdClaude)(args);
         case "channel": {
             // The Claude Code channel server (docs/features/CLAUDE_CODE_CHANNEL.md). Claude Code starts
             // it; like `mcp`, it blocks on stdio and exits when Claude Code closes its stdin.

package/dist/start-command.js

@@ -136,8 +136,9 @@ async function cmdStart(args) {
     // `connect claude` registered the server and this Claude Code is new enough to take the flag
     // (an unknown flag would stop it starting). Otherwise it starts exactly as before and the
     // session listens through a Monitor.
-    const agentArgs = runtime === "claude" ? channelArgs(binary.path) : [];
-    const env = agentArgs.length ? { ...process.env, BAYCHAT_CHANNEL: "1" } : process.env;
+    const channel = runtime === "claude" ? (0, launch_1.channelLaunchFor)(binary.path) : undefined;
+    const agentArgs = channel?.args ?? [];
+    const env = { ...process.env, ...(channel?.env ?? {}) };
     // ALREADY INSIDE ONE? Then just run the agent. Nesting multiplexers sends every prefix
     // key to the wrong one, and the person already has everything this command provides.
     const inside = (0, terminal_pane_1.detectPane)();
@@ -241,12 +242,3 @@ function valueAfter(args, flagName) {
     const index = args.indexOf(flagName);
     return index === -1 ? undefined : args[index + 1];
 }
-/** The channel flag for this Claude Code, or nothing when it is not registered or too old. */
-function channelArgs(claudePath) {
-    if (!(0, launch_1.channelRegistered)())
-        return [];
-    const probe = (0, child_process_1.spawnSync)(claudePath, ["--version"], { encoding: "utf8", timeout: 10_000 });
-    if (probe.error || probe.status !== 0)
-        return [];
-    return (0, launch_1.claudeSupportsChannel)((0, launch_1.parseClaudeVersion)(String(probe.stdout ?? ""))) ? [...launch_1.CHANNEL_LAUNCH_ARGS] : [];
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baychat",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "BayChat connector CLI — pair an agent session (Claude Code, Codex, Cursor) with BayChat, or have the relay run DeepSeek or the Cursor CLI for you",
   "bin": {
     "baychat": "dist/index.js"