cimux-mcp 0.2.0 → 0.2.2

package/README.md

@@ -1,9 +1,39 @@
 # Cimux
 
+[![npm version](https://img.shields.io/npm/v/cimux-mcp)](https://www.npmjs.com/package/cimux-mcp)
+[![CI](https://github.com/jackkslash/cimux/actions/workflows/ci.yml/badge.svg)](https://github.com/jackkslash/cimux/actions/workflows/ci.yml)
+
 Local-first mailboxes for intentional AI agent context handoffs.
 
 Cimux gives concurrent coding agents a simple way to pass context without dumping every detail into every session. A sender creates a structured Context Package, addressed to a mailbox such as `codex/backend-auth` or `claude/frontend-login`. The receiver can preview the inbox cheaply, read the full package only when it matters, and ack it after loading.
 
+## What it looks like
+
+One agent finishes a piece of work and hands off:
+
+```text
+Codex session                          Claude Code session
+─────────────────                      ────────────────────
+send_context ──────────────────────▶   (user types anything)
+  to: claude/frontend-login              hook: "Cimux: 1 unread context
+  title: Login bug root cause             package(s) for claude/frontend-login
+  summary: Session cookie dropped         from codex/backend-auth. Call
+           on redirect                    check_inbox to preview."
+  artifacts: 2 files, 1 commit
+                                        check_inbox   → preview (~40 tokens)
+                                        read_context  → full body + artifacts
+                                        ack_context   → sender can see it landed
+```
+
+The receiver's context stays clean until the moment the handoff actually matters. Empty inboxes cost zero tokens — the hook prints nothing.
+
+## Why not just a shared notes file?
+
+- **Token discipline.** A shared markdown file gets pasted into sessions whole. Cimux previews keep each unread handoff to a ~40-token summary until an agent decides to read it — bodies, code snippets, and payloads never enter context uninvited.
+- **Delivery state.** Files can't tell you whether the other agent ever saw the note. Every Context Package tracks read and acknowledged state (first write wins, safe across concurrent processes), so a handoff is a receipt, not a hope.
+- **Addressing.** Mailboxes are per harness and workstream (`codex/backend-auth`), inferred automatically from the git branch — parallel agents don't trample one shared document.
+- **Cross-harness, repo-clean.** Works between Claude Code, Codex (app or CLI), and Cursor through one local SQLite database in `~/.cimux/` — nothing gets committed to your repo.
+
 The product idea is intentionally small:
 
 - anyone can send to an existing mailbox
@@ -18,25 +48,28 @@ The product idea is intentionally small:
 Included now:
 
 - Context Package schema
-- SQLite storage
+- SQLite storage (WAL, safe for concurrent sessions)
 - mailbox registration and name inference
 - MCP server with mailbox tools
-- zero-token notification command
+- zero-token notification hook and session-start briefing
+- agent norms installed to `CLAUDE.md`/`AGENTS.md` so agents hand off without prompting
 - safe installer for Codex and Claude config targets
 - local CLI commands for debugging and demos
+- prototype read-only mail viewer (`node scripts/mail-viewer.mjs`)
 
 Not included yet:
 
+- message or mailbox deletion
 - hosted SaaS mode
 - vector search or embeddings
 - automatic routing
 - remote auth
-- read-only inspector UI
-
-See [docs/mvp-readiness.md](docs/mvp-readiness.md) for the release checklist and known limits.
+- polished inspector UI (`cimux ui`)
 
 ## Install
 
+Requires Node >= 22.13 (Cimux uses the built-in `node:sqlite` — no native dependencies).
+
 From npm (package `cimux-mcp`, command `cimux`):
 
 ```bash
@@ -45,6 +78,19 @@ cimux install --dry-run
 cimux install
 ```
 
+`cimux install` detects which harnesses are on your machine and writes config only for those (`--harness <name>` for one, `--all` for every supported harness):
+
+| | Claude Code | Codex (app or CLI) | Cursor |
+| --- | --- | --- | --- |
+| MCP server | `~/.claude.json` | `~/.codex/config.toml` | `~/.cursor/mcp.json` |
+| Hooks | notify + brief, `~/.claude/settings.json` | notify + brief, `~/.codex/hooks.json` | session brief, `~/.cursor/hooks.json` |
+| Agent norms | `~/.claude/CLAUDE.md` | `~/.codex/AGENTS.md` | — (via session brief) |
+
+Harness notes:
+
+- Codex asks you to trust the hooks once (and again after any change to them) — that's Codex's own safety prompt, expected behavior.
+- Cursor has no context-injecting per-prompt hook, so agents get the mailbox briefing (including unread count) at session start rather than a notification on every prompt. Cursor keeps user-level rules in its settings GUI, so the handoff norms travel in the brief instead of a rules file.
+
 ## Install Locally
 
 From the repo:
@@ -76,6 +122,7 @@ For hook checks, users should not have to remember a name. `cimux notify --harne
 Cimux exposes:
 
 - `register_session`
+- `list_mailboxes`
 - `send_context`
 - `check_inbox`
 - `read_context`
@@ -83,8 +130,8 @@ Cimux exposes:
 
 Typical flow:
 
-1. A session registers or infers its mailbox.
-2. Another session sends a Context Package to that mailbox.
+1. A session starts; the `SessionStart` hook briefs the agent on its mailbox and unread count.
+2. Another session finds the recipient with `list_mailboxes` and sends a Context Package.
 3. The receiver sees a hook notification on the next user prompt if unread mail exists.
 4. The receiver calls `check_inbox` to preview.
 5. The receiver calls `read_context` for the full package.
@@ -104,10 +151,11 @@ cimux send \
   --title "Auth handoff" \
   --summary "Frontend should handle the new auth error." \
   --body "validateSession now throws ExpiredSessionError." \
-  --tags auth,frontend
+  --tags auth,frontend \
+  --artifacts-json '{"files":[{"path":"src/auth/session.ts"}]}'
 
 cimux notify --mailbox claude/frontend-login
-cimux check --mailbox claude/frontend-login
+cimux check --mailbox claude/frontend-login --limit 5
 cimux read --mailbox claude/frontend-login --id <context-id>
 cimux ack --mailbox claude/frontend-login --id <context-id> --note "Loaded."
 ```
@@ -127,7 +175,3 @@ npm run build
 npm run demo:local
 npm pack --dry-run
 ```
-
-## MVP Readiness
-
-Before calling a build MVP-complete, run the automated checks and manual harness verification in [docs/mvp-readiness.md](docs/mvp-readiness.md).

package/dist/bin.js

@@ -1,4 +1,13 @@
 #!/usr/bin/env node
-import { runCimuxCli } from "./cli/cimux-cli.js";
+// Check the runtime before importing anything: node:sqlite (used by the
+// storage layer) is only available unflagged from Node 22.13, and importing
+// it on older versions crashes with an unhelpful builtin-module error.
+const [major = 0, minor = 0] = process.versions.node.split(".").map(Number);
+if (major < 22 || (major === 22 && minor < 13)) {
+    console.error(`cimux requires Node >= 22.13 (for node:sqlite). You are running ${process.versions.node}.`);
+    process.exit(1);
+}
+const { runCimuxCli } = await import("./cli/cimux-cli.js");
 process.exitCode = await runCimuxCli(process.argv.slice(2));
+export {};
 //# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,CAAC,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA,wEAAwE;AACxE,4EAA4E;AAC5E,uEAAuE;AACvE,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC5E,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC;IAC/C,OAAO,CAAC,KAAK,CACX,mEAAmE,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG,CAC5F,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC3D,OAAO,CAAC,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli/cimux-cli.d.ts

@@ -1,10 +1,3 @@
-export type CimuxCliIo = {
-    log(message: string): void;
-    error(message: string): void;
-};
-export type CimuxCliEnv = {
-    CIMUX_DB_PATH?: string;
-    CIMUX_MAILBOX?: string;
-    CIMUX_HARNESS?: string;
-};
+import type { CimuxCliEnv, CimuxCliIo } from "./shared.js";
+export type { CimuxCliEnv, CimuxCliIo } from "./shared.js";
 export declare function runCimuxCli(argv: string[], env?: CimuxCliEnv, cwd?: string, io?: CimuxCliIo): Promise<number>;

package/dist/cli/cimux-cli.js

@@ -1,207 +1,77 @@
-import path from "node:path";
-import { applyInstallPlan, createInstallPlan } from "../install/cimux-install-plan.js";
-import { defaultDatabasePath, runCimuxMcpServer } from "../mcp/cimux-mcp-server.js";
-import { resolveRuntimeMailbox } from "../runtime/mailbox-runtime.js";
-import { ackContext, checkInbox, createInboxNotification, createSessionBrief, listMailboxes, readContext, registerSession, sendContext } from "../service/cimux-mailbox-service.js";
-import { SQLiteCimuxStore } from "../storage/sqlite-cimux-store.js";
+import { parseArgs } from "node:util";
+import { ZodError } from "zod";
 import { name, version } from "../version.js";
+import { ackCommand } from "./commands/ack.js";
+import { briefCommand } from "./commands/brief.js";
+import { checkCommand } from "./commands/check.js";
+import { installCommand } from "./commands/install.js";
+import { mailboxesCommand } from "./commands/mailboxes.js";
+import { mcpCommand } from "./commands/mcp.js";
+import { notifyCommand } from "./commands/notify.js";
+import { readCommand } from "./commands/read.js";
+import { registerCommand } from "./commands/register.js";
+import { sendCommand } from "./commands/send.js";
+const commands = [
+    mcpCommand,
+    installCommand,
+    notifyCommand,
+    briefCommand,
+    registerCommand,
+    mailboxesCommand,
+    sendCommand,
+    checkCommand,
+    readCommand,
+    ackCommand
+];
 export async function runCimuxCli(argv, env = process.env, cwd = process.cwd(), io = console) {
     const command = argv[0];
-    try {
-        if (!command || command === "help" || command === "--help" || command === "-h") {
-            io.log(usage());
-            return 0;
-        }
-        if (command === "version" || command === "--version" || command === "-v") {
-            io.log(`${name} ${version}`);
-            return 0;
-        }
-        if (command === "mcp") {
-            await runCimuxMcpServer(env.CIMUX_DB_PATH);
-            return 0;
-        }
-        if (command === "notify") {
-            return await runNotifyCommand(argv, env, cwd, io);
-        }
-        if (command === "brief") {
-            return await runBriefCommand(argv, env, cwd, io);
-        }
-        if (command === "mailboxes") {
-            return await withStore(env, async (store) => {
-                writeJson(io, await listMailboxes(store));
-                return 0;
-            });
-        }
-        if (command === "install") {
-            return runInstallCommand(argv, io);
-        }
-        if (command === "register") {
-            return await withStore(env, async (store) => {
-                const mailbox = resolveRuntimeMailboxFromArgs(argv, env, cwd);
-                const result = await registerSession(store, {
-                    harness: readArg(argv, "--harness") ?? env.CIMUX_HARNESS ?? "codex",
-                    ...(mailbox.inferredFrom === "explicit"
-                        ? { explicitMailbox: mailbox.mailbox }
-                        : {
-                            branchName: mailbox.branchName ?? undefined,
-                            folderName: mailbox.folderName
-                        })
-                });
-                writeJson(io, result);
-                return 0;
-            });
-        }
-        if (command === "send") {
-            return await withStore(env, async (store) => {
-                const result = await sendContext(store, {
-                    fromMailbox: requireArg(argv, "--from"),
-                    toMailbox: requireArg(argv, "--to"),
-                    title: requireArg(argv, "--title"),
-                    summary: requireArg(argv, "--summary"),
-                    body: requireArg(argv, "--body"),
-                    tags: readCsvArg(argv, "--tags"),
-                    artifacts: {},
-                    payload: {}
-                });
-                writeJson(io, result);
-                return 0;
-            });
-        }
-        if (command === "check") {
-            return await withStore(env, async (store) => {
-                const result = await checkInbox(store, {
-                    mailbox: requireArg(argv, "--mailbox"),
-                    unreadOnly: !argv.includes("--all")
-                });
-                writeJson(io, result);
-                return 0;
-            });
-        }
-        if (command === "read") {
-            return await withStore(env, async (store) => {
-                const result = await readContext(store, {
-                    mailbox: requireArg(argv, "--mailbox"),
-                    id: requireArg(argv, "--id")
-                });
-                writeJson(io, result);
-                return 0;
-            });
-        }
-        if (command === "ack") {
-            return await withStore(env, async (store) => {
-                const note = readArg(argv, "--note");
-                const result = await ackContext(store, {
-                    mailbox: requireArg(argv, "--mailbox"),
-                    id: requireArg(argv, "--id"),
-                    ...(note === undefined ? {} : { note })
-                });
-                writeJson(io, result);
-                return 0;
-            });
-        }
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        io.log(usage());
+        return 0;
+    }
+    if (command === "version" || command === "--version" || command === "-v") {
+        io.log(`${name} ${version}`);
+        return 0;
+    }
+    const spec = commands.find((candidate) => candidate.name === command);
+    if (!spec) {
+        io.error(`Unknown command: ${command}`);
+        io.error("");
         io.error(usage());
         return 1;
     }
+    let values;
+    try {
+        // strict mode rejects unknown flags and flags missing their value, so
+        // typos fail loudly instead of being silently swallowed.
+        values = parseArgs({
+            args: argv.slice(1),
+            options: spec.options,
+            strict: true,
+            allowPositionals: false
+        }).values;
+    }
     catch (error) {
         io.error(error instanceof Error ? error.message : String(error));
+        io.error(`Usage: ${spec.usage}`);
         return 1;
     }
-}
-async function runNotifyCommand(argv, env, cwd, io) {
-    return withStore(env, async (store) => {
-        const { mailbox } = resolveRuntimeMailboxFromArgs(argv, env, cwd);
-        // Hook checks also act as a heartbeat for the current local session name.
-        // Creation is idempotent, so this does not reset existing mailbox state.
-        await store.createMailbox(mailbox);
-        const result = await createInboxNotification(store, { mailbox });
-        if (result.message) {
-            io.log(result.message);
-        }
-        return 0;
-    });
-}
-async function runBriefCommand(argv, env, cwd, io) {
-    return withStore(env, async (store) => {
-        const { mailbox } = resolveRuntimeMailboxFromArgs(argv, env, cwd);
-        // Runs from a SessionStart hook: register the session's mailbox, then
-        // print the norms so agents use Cimux without being prompted.
-        await store.createMailbox(mailbox);
-        const result = await createSessionBrief(store, { mailbox });
-        io.log(result.message);
-        return 0;
-    });
-}
-function runInstallCommand(argv, io) {
-    const plan = createInstallPlan({ packageCommand: resolvePackageCommand() });
-    if (!argv.includes("--dry-run")) {
-        const results = applyInstallPlan(plan);
-        for (const result of results) {
-            const backup = result.backupPath ? ` backup: ${result.backupPath}` : "";
-            io.log(`${result.status}: ${result.path}${backup}`);
-        }
-        return 0;
-    }
-    for (const target of plan.targets) {
-        io.log(`# ${target.harness}: ${target.path}`);
-        io.log(`# ${target.purpose}`);
-        io.log(target.snippet);
-    }
-    return 0;
-}
-function resolvePackageCommand() {
-    // GUI-launched harnesses (e.g. the Codex desktop app) do not inherit the
-    // shell PATH, so write the absolute path of the running bin into config.
-    const binPath = process.argv[1];
-    return binPath && path.isAbsolute(binPath) ? binPath : "cimux";
-}
-async function withStore(env, callback) {
-    const store = new SQLiteCimuxStore(env.CIMUX_DB_PATH ?? defaultDatabasePath());
     try {
-        return await callback(store);
-    }
-    finally {
-        store.close();
-    }
-}
-function resolveRuntimeMailboxFromArgs(argv, env, cwd) {
-    const explicitMailbox = readArg(argv, "--mailbox") ?? env.CIMUX_MAILBOX;
-    const harness = readArg(argv, "--harness") ?? env.CIMUX_HARNESS;
-    if (!explicitMailbox && !harness) {
-        throw new Error("Expected --mailbox <harness/name> or --harness <name>");
-    }
-    return resolveRuntimeMailbox({
-        ...(explicitMailbox === undefined ? {} : { explicitMailbox }),
-        ...(harness === undefined ? {} : { harness }),
-        cwd
-    });
-}
-function readArg(argv, name) {
-    const exact = argv.indexOf(name);
-    if (exact >= 0) {
-        return argv[exact + 1];
+        return await spec.run({ values, env, cwd, io });
     }
-    const prefixed = argv.find((arg) => arg.startsWith(`${name}=`));
-    return prefixed?.slice(name.length + 1);
-}
-function requireArg(argv, name) {
-    const value = readArg(argv, name);
-    if (!value) {
-        throw new Error(`Expected ${name}`);
-    }
-    return value;
-}
-function readCsvArg(argv, name) {
-    const value = readArg(argv, name);
-    if (!value) {
-        return [];
+    catch (error) {
+        if (error instanceof ZodError) {
+            io.error("Invalid input:");
+            for (const issue of error.issues) {
+                const flag = issue.path.length > 0 ? `--${issue.path.join(".")}` : "input";
+                io.error(`  ${flag}: ${issue.message}`);
+            }
+            io.error(`Usage: ${spec.usage}`);
+            return 1;
+        }
+        io.error(error instanceof Error ? error.message : String(error));
+        return 1;
     }
-    return value
-        .split(",")
-        .map((item) => item.trim())
-        .filter(Boolean);
-}
-function writeJson(io, value) {
-    io.log(JSON.stringify(value, null, 2));
 }
 function usage() {
     return [
@@ -210,16 +80,7 @@ function usage() {
         "Local-first mailboxes for intentional AI agent context handoffs.",
         "",
         "Usage:",
-        "  cimux mcp",
-        "  cimux install [--dry-run]",
-        "  cimux notify [--mailbox <harness/name> | --harness <name>]",
-        "  cimux brief [--mailbox <harness/name> | --harness <name>]",
-        "  cimux register [--mailbox <harness/name> | --harness <name>]",
-        "  cimux mailboxes",
-        "  cimux send --from <mailbox> --to <mailbox> --title <title> --summary <summary> --body <body> [--tags a,b]",
-        "  cimux check --mailbox <harness/name> [--all]",
-        "  cimux read --mailbox <harness/name> --id <context-id>",
-        "  cimux ack --mailbox <harness/name> --id <context-id> [--note <note>]",
+        ...commands.map((spec) => `  ${spec.usage}`),
         "",
         "Examples:",
         "  cimux install --dry-run",

package/dist/cli/cimux-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cimux-cli.js","sourceRoot":"","sources":["../../src/cli/cimux-cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cimux-cli.js","sourceRoot":"","sources":["../../src/cli/cimux-cli.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/ack.d.ts

@@ -0,0 +1,2 @@
+import type { CommandSpec } from "../shared.js";
+export declare const ackCommand: CommandSpec;

package/dist/cli/commands/ack.js

@@ -0,0 +1,24 @@
+import { ackContext } from "../../service/cimux-mailbox-service.js";
+import { readString, requireString, withStore, writeJson } from "../shared.js";
+export const ackCommand = {
+    name: "ack",
+    usage: "cimux ack --mailbox <harness/name> --id <context-id> [--note <note>]",
+    options: {
+        mailbox: { type: "string" },
+        id: { type: "string" },
+        note: { type: "string" }
+    },
+    run(context) {
+        return withStore(context.env, async (store) => {
+            const note = readString(context.values, "note");
+            const result = await ackContext(store, {
+                mailbox: requireString(context.values, "mailbox"),
+                id: requireString(context.values, "id"),
+                ...(note === undefined ? {} : { note })
+            });
+            writeJson(context.io, result);
+            return 0;
+        });
+    }
+};
+//# sourceMappingURL=ack.js.map

package/dist/cli/commands/ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack.js","sourceRoot":"","sources":["../../../src/cli/commands/ack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG/E,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,sEAAsE;IAC7E,OAAO,EAAE;QACP,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzB;IACD,GAAG,CAAC,OAAO;QACT,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE;gBACrC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;gBACjD,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;gBACvC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;aACxC,CAAC,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/brief.d.ts

@@ -0,0 +1,2 @@
+import type { CommandSpec } from "../shared.js";
+export declare const briefCommand: CommandSpec;

package/dist/cli/commands/brief.js

@@ -0,0 +1,33 @@
+import { createSessionBrief } from "../../service/cimux-mailbox-service.js";
+import { readString, resolveRuntimeMailboxFromArgs, withStore } from "../shared.js";
+export const briefCommand = {
+    name: "brief",
+    usage: "cimux brief [--mailbox <harness/name> | --harness <name>] [--format text|cursor]",
+    options: {
+        mailbox: { type: "string" },
+        harness: { type: "string" },
+        format: { type: "string" }
+    },
+    run(context) {
+        const format = readString(context.values, "format") ?? "text";
+        if (format !== "text" && format !== "cursor") {
+            throw new Error(`Unknown format: ${format} (supported: text, cursor)`);
+        }
+        return withStore(context.env, async (store) => {
+            const { mailbox } = resolveRuntimeMailboxFromArgs(context);
+            // Runs from a SessionStart hook: register the session's mailbox, then
+            // print the norms so agents use Cimux without being prompted.
+            await store.createMailbox(mailbox);
+            const result = await createSessionBrief(store, { mailbox });
+            // Cursor hooks reply with JSON on stdout instead of plain text.
+            if (format === "cursor") {
+                context.io.log(JSON.stringify({ additional_context: result.message }));
+            }
+            else {
+                context.io.log(result.message);
+            }
+            return 0;
+        });
+    }
+};
+//# sourceMappingURL=brief.js.map

package/dist/cli/commands/brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../../src/cli/commands/brief.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpF,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,kFAAkF;IACzF,OAAO,EAAE;QACP,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC3B;IACD,GAAG,CAAC,OAAO;QACT,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC;QAC9D,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,4BAA4B,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;YAE3D,sEAAsE;YACtE,8DAA8D;YAC9D,MAAM,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAE5D,gEAAgE;YAChE,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/check.d.ts

@@ -0,0 +1,2 @@
+import type { CommandSpec } from "../shared.js";
+export declare const checkCommand: CommandSpec;

package/dist/cli/commands/check.js

@@ -0,0 +1,24 @@
+import { checkInbox } from "../../service/cimux-mailbox-service.js";
+import { readString, requireString, withStore, writeJson } from "../shared.js";
+export const checkCommand = {
+    name: "check",
+    usage: "cimux check --mailbox <harness/name> [--all] [--limit <n>]",
+    options: {
+        mailbox: { type: "string" },
+        all: { type: "boolean" },
+        limit: { type: "string" }
+    },
+    run(context) {
+        return withStore(context.env, async (store) => {
+            const limit = readString(context.values, "limit");
+            const result = await checkInbox(store, {
+                mailbox: requireString(context.values, "mailbox"),
+                unreadOnly: context.values.all !== true,
+                ...(limit === undefined ? {} : { limit: Number(limit) })
+            });
+            writeJson(context.io, result);
+            return 0;
+        });
+    }
+};
+//# sourceMappingURL=check.js.map

package/dist/cli/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG/E,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,4DAA4D;IACnE,OAAO,EAAE;QACP,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B;IACD,GAAG,CAAC,OAAO;QACT,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE;gBACrC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;gBACjD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI;gBACvC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,2 @@
+import type { CommandSpec } from "../shared.js";
+export declare const installCommand: CommandSpec;