@brutalsystems/muster 0.7.16 → 0.7.17

package/README.md

@@ -892,8 +892,12 @@ selected external tool may have its own write or network capabilities.
 Installed deliberately, in the one session that should hold spawn authority —
 never at user scope.
 
-Muster exposes `run`, `list`, `stop`, and `output` over stdio. No arguments or
-`mcp` starts the server. Diagnostics go to stderr, never protocol stdout.
+Muster exposes `run`, `list`, `stop`, and `output` over stdio. `mcp` starts the
+server, and so does no arguments when stdin is not a terminal — which is what an
+MCP client provides. Typing `muster` at a terminal prints the usage text and a
+short status instead, because a server waiting for JSON-RPC on stdin is
+indistinguishable from a hang. `muster mcp` starts the server either way, so it
+can still be driven by hand to debug it. Diagnostics go to stderr, never protocol stdout.
 Schemas match the CLI (`args` is the array of optional runtime arguments).
 
 For a single Codex session, use per-invocation configuration:

package/dist/format.js

@@ -100,3 +100,29 @@ export function formatHuman(value, color = false) {
             : "No Muster runs.\n";
     return recordHuman(value, color) + "\n";
 }
+/**
+ * What a human sees when they type `muster` with no arguments at a terminal.
+ *
+ * With no arguments Muster starts the MCP server, which from a terminal looks
+ * exactly like a hang — the process is waiting for JSON-RPC on stdin and has
+ * nothing to say. The server path is reached by a pipe, never a TTY, so a
+ * terminal can be answered without changing what any MCP client gets.
+ *
+ * The session count is what the registry recorded, not what is running: it is
+ * read without the refresh `list` performs, because that refresh also reaps a
+ * terminal entry's identity copy and reaches an OpenCode session over HTTP.
+ * Neither belongs in the output of typing a bare command, so the wording says
+ * "recorded" and points at `list` for the authoritative answer.
+ */
+export function statusText(identities, sessions) {
+    const lines = [];
+    if (!identities.length)
+        lines.push("No identities yet — add one with:", "    muster setup-identity --identity NAME --agent <codex|claude|opencode> --interactive");
+    else
+        lines.push(`${identities.length} ${identities.length === 1 ? "identity" : "identities"} — ` +
+            identities.map((i) => `${i.name} ${i.auth.state}`).join(", "));
+    lines.push(sessions === 0
+        ? "No recorded sessions."
+        : `${sessions} recorded session${sessions === 1 ? "" : "s"} (muster list refreshes)`, "", "Starting the MCP server? Use `muster mcp`.");
+    return lines.join("\n") + "\n";
+}

package/dist/muster.js

@@ -7,7 +7,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextpro
 import { z } from "zod";
 import { Muster } from "./run.js";
 import { delay } from "./identity/processes.js";
-import { formatHuman, humanColorEnabled } from "./format.js";
+import { formatHuman, humanColorEnabled, statusText } from "./format.js";
 import { checkPlugins, npmRegistry } from "./doctor.js";
 import { loadConfig, musterHome } from "./config.js";
 import { describeIdentities, interactiveSetup, setupIdentity, } from "./identity-cli.js";
@@ -102,14 +102,38 @@ async function main() {
         process.stdout.write(`${version}\n`);
         return;
     }
-    const mcp = argv.length === 0 || argv[0] === "mcp";
-    if (mcp && argv.length > 1)
+    // No arguments starts the MCP server: a documented entry point, and how a
+    // client configured with `command: "muster"` and no args reaches it. From a
+    // terminal that is indistinguishable from a hang — the process is waiting for
+    // JSON-RPC on stdin and has nothing to say. A client always arrives down a
+    // pipe and never a TTY, so a person can be answered without changing what any
+    // client gets. `muster mcp` stays unconditional, so the server can still be
+    // driven by hand in a terminal to debug it.
+    const bareAtTerminal = argv.length === 0 && Boolean(process.stdin.isTTY);
+    const mcp = !bareAtTerminal && (argv.length === 0 || argv[0] === "mcp");
+    if (argv[0] === "mcp" && argv.length > 1)
         throw new Error("mcp takes no arguments");
     const muster = await Muster.create();
     let shutdown;
     const close = () => (shutdown ??= (async () => {
         await muster.close();
     })());
+    if (bareAtTerminal) {
+        try {
+            const cfg = await loadConfig();
+            const view = await describeIdentities(musterHome(), process.env, Object.fromEntries(Object.entries(cfg.requester_profiles).map(([n, p]) => [
+                n,
+                p.identities,
+            ])));
+            process.stdout.write(help +
+                "\n" +
+                statusText(view.identities, (await muster.summary()).sessions));
+        }
+        finally {
+            await close();
+        }
+        return;
+    }
     for (const signal of ["SIGTERM", "SIGINT", "SIGHUP"])
         process.once(signal, () => {
             void close().then(() => process.exit(0), (e) => {

package/dist/run.js

@@ -823,6 +823,21 @@ export class Muster {
      * with the supported entry point (#44), which is also what would need to
      * choose between hiding other requesters' entries and redacting them.
      */
+    /**
+     * Counts for the status line a bare `muster` prints at a terminal.
+     *
+     * Deliberately not `list`. That refreshes every entry, and a refresh removes
+     * a terminal entry's identity copy and MCP config and reaches an OpenCode
+     * session over HTTP — none of which belongs in the output of typing a bare
+     * command. This reads the registry and changes nothing, so what it reports is
+     * what was recorded rather than what is running, and the caller says so.
+     */
+    async summary() {
+        const entries = await this.registry.all();
+        return {
+            sessions: entries.filter((e) => e.kind === "session" && ["starting", "running"].includes(e.status)).length,
+        };
+    }
     async list(kind) {
         const entries = await this.registry.all();
         const result = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brutalsystems/muster",
-  "version": "0.7.16",
+  "version": "0.7.17",
   "description": "Launch instructed, reachable local agent sessions",
   "type": "module",
   "engines": {