@matterailab/orbcode 0.1.4 → 0.1.5

package/README.md

@@ -7,6 +7,8 @@ models, the same native tool schemas, the same MatterAI auth backend — rebuilt
 scratch as an interactive TUI with streaming chat, live thinking display, tool
 activity rows, edit/command approvals, and todo tracking.
 
+![OrbCode CLI screenshot](assets/orbcode-screenshot.webp)
+
 ---
 
 ## Table of contents

package/dist/index.js

@@ -4,6 +4,8 @@ import { PRODUCT_NAME, VERSION } from "./branding.js";
 import { App } from "./ui/App.js";
 import { runHeadless } from "./headless.js";
 import { loadSessionById } from "./core/sessions.js";
+import { clearUpdateCache, compareVersions, fetchLatestNpmVersion, getGlobalInstallRoot, getUpdateInfo, isGlobalInstall, runNpmUpdate, } from "./utils/updateCheck.js";
+const PACKAGE_NAME = "@matterailab/orbcode";
 function printHelp() {
     console.log(`${PRODUCT_NAME} v${VERSION}
 
@@ -11,6 +13,7 @@ Usage:
   orbcode                 start an interactive session
   orbcode "<prompt>"      start an interactive session with an initial prompt
   orbcode login           sign in to MatterAI
+  orbcode update          install the latest version from npm
   orbcode -p "<prompt>"   run a single prompt non-interactively (prints only the final response)
   orbcode -p "…" --yolo   non-interactive with auto-approved edits/commands
   orbcode --model <id>    use a specific model for this run
@@ -19,6 +22,32 @@ Usage:
   orbcode --help          show this help
 `);
 }
+async function runUpdate() {
+    const latest = await fetchLatestNpmVersion(PACKAGE_NAME);
+    if (latest === null) {
+        console.error("Could not reach the npm registry. Check your network connection and try again.");
+        return 1;
+    }
+    if (compareVersions(VERSION, latest) >= 0) {
+        console.log(`${PRODUCT_NAME} v${VERSION} is already up to date (latest: v${latest}).`);
+        return 0;
+    }
+    console.log(`Updating ${PRODUCT_NAME} v${VERSION} → v${latest}…`);
+    const global = isGlobalInstall();
+    if (!global) {
+        const root = await getGlobalInstallRoot();
+        console.error(`This CLI was not installed globally (argv[1] = ${process.argv[1] || "<unknown>"}).\n` +
+            `To update a local/dev install, run \`npm install -g ${PACKAGE_NAME}@latest\` manually, or \`npm install\` inside the source checkout.` +
+            (root ? `\nGlobal install root detected at: ${root}` : ""));
+        return 1;
+    }
+    clearUpdateCache();
+    const code = await runNpmUpdate(PACKAGE_NAME);
+    if (code === 0) {
+        console.log(`Updated to v${latest}. Run \`${PRODUCT_NAME.split(" ")[0].toLowerCase()}\` again to use it.`);
+    }
+    return code;
+}
 /** Pop `flag <value>` (accepting -flag and --flag) out of args; returns the value. */
 function takeFlagValue(args, name) {
     const index = args.findIndex((a) => a === `--${name}` || a === `-${name}`);
@@ -42,6 +71,10 @@ async function main() {
         printHelp();
         return;
     }
+    if (args[0] === "update") {
+        const code = await runUpdate();
+        process.exit(code);
+    }
     const model = takeFlagValue(args, "model") ?? takeFlagValue(args, "m");
     if (model) {
         // loadSettings() treats ORBCODE_MODEL as the highest-precedence override,
@@ -76,7 +109,10 @@ async function main() {
         process.stdout.write("\x1b[2J\x1b[H");
         process.stdout.write("\x1b]0;orbcode\x07");
     }
-    render(_jsx(App, { initialView: initialView, initialPrompt: initialPrompt, initialSession: initialSession }));
+    // Fire-and-forget: a stale or no-network state just means the header shows
+    // the "current version" line instead of an upgrade prompt.
+    const updateCheckPromise = getUpdateInfo(PACKAGE_NAME, VERSION);
+    render(_jsx(App, { initialView: initialView, initialPrompt: initialPrompt, initialSession: initialSession, updateCheck: updateCheckPromise }));
 }
 main().catch((error) => {
     console.error(error);

package/dist/ui/App.js

@@ -142,10 +142,11 @@ let rowCounter = 0;
 function rowId() {
     return `row-${rowCounter++}`;
 }
-export function App({ initialView, initialPrompt, initialSession, }) {
+export function App({ initialView, initialPrompt, initialSession, updateCheck, }) {
     const { exit } = useApp();
     const [settings, setSettings] = useState(() => loadSettings());
     const [view, setView] = useState(initialView ?? (getAuthToken(settings) ? "chat" : "login"));
+    const [updateInfo, setUpdateInfo] = useState(null);
     const [rows, setRows] = useState(() => [
         { kind: "header", id: "header", cwd: process.cwd(), modelName: getModel(loadSettings().model).name },
     ]);
@@ -156,6 +157,10 @@ export function App({ initialView, initialPrompt, initialSession, }) {
     const [runningTool, setRunningTool] = useState(null);
     const [pendingApproval, setPendingApproval] = useState(null);
     const [pendingFollowup, setPendingFollowup] = useState(null);
+    // FIFO queue of messages the user typed while the LLM was still streaming.
+    // Drained one-per-turn on each `turn-end` event so multi-step work can
+    // keep flowing without making the user wait for the previous response.
+    const [queuedMessages, setQueuedMessages] = useState([]);
     const [modelPickerOpen, setModelPickerOpen] = useState(false);
     const [resumableSessions, setResumableSessions] = useState(null);
     const [staticKey, setStaticKey] = useState(0);
@@ -184,6 +189,26 @@ export function App({ initialView, initialPrompt, initialSession, }) {
     const textBufferRef = useRef("");
     // taskId for which a title fetch has already been started (once per task).
     const titleTaskRef = useRef(null);
+    // Mirror of `queuedMessages` for the agent event handler (kept on a ref so
+    // we can drain it inside `handleEvent` without re-creating that callback
+    // on every keystroke).
+    const queueRef = useRef([]);
+    const enqueueMessage = useCallback((text) => {
+        queueRef.current = [...queueRef.current, text];
+        setQueuedMessages(queueRef.current);
+    }, []);
+    const drainQueue = useCallback(() => {
+        if (queueRef.current.length === 0)
+            return null;
+        const [next, ...rest] = queueRef.current;
+        queueRef.current = rest;
+        setQueuedMessages(rest);
+        return next;
+    }, []);
+    const clearQueue = useCallback(() => {
+        queueRef.current = [];
+        setQueuedMessages([]);
+    }, []);
     const maybeFetchTitle = useCallback(() => {
         const agent = agentRef.current;
         if (!agent || titleTaskRef.current === agent.taskId)
@@ -289,9 +314,25 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                 setBusy(false);
                 maybeFetchTitle();
                 refreshUsage();
+                // Pop the next queued message and immediately start a new
+                // turn on top of the one that just ended. The agent's
+                // `runTurn` is fully resolved at this point (its
+                // `finally` emitted this event), so the new turn picks
+                // up the up-to-date conversation history. We use
+                // `agentRef` directly here to avoid a circular
+                // `handleEvent` ↔ `getAgent` reference; the ref is
+                // guaranteed populated because `runTurn` set it
+                // synchronously before emitting this event.
+                const nextQueued = drainQueue();
+                if (nextQueued !== null && agentRef.current) {
+                    pushRow({ kind: "user", text: nextQueued });
+                    setBusy(true);
+                    setBusyLabel("Thinking");
+                    void agentRef.current.runTurn(nextQueued);
+                }
                 break;
         }
-    }, [pushRow, maybeFetchTitle, refreshUsage]);
+    }, [pushRow, maybeFetchTitle, refreshUsage, drainQueue]);
     const createAgent = useCallback((resume) => {
         const current = loadSettings();
         return new Agent({
@@ -391,6 +432,7 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                 break;
             case "/new":
                 // Drop the agent entirely so the next message starts a fresh session.
+                clearQueue();
                 agentRef.current = null;
                 titleTaskRef.current = null;
                 setSessionTitle("");
@@ -514,6 +556,7 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                 setView("login");
                 break;
             case "/logout": {
+                clearQueue();
                 const updated = { ...settings, token: undefined };
                 setSettings(updated);
                 saveSettings(updated);
@@ -527,7 +570,7 @@ export function App({ initialView, initialPrompt, initialSession, }) {
             default:
                 pushRow({ kind: "error", text: `Unknown command: ${name}. Try /help.` });
         }
-    }, [settings, tasks, contextTokens, totalCost, sessionTitle, exit, pushRow, getAgent, switchModel, resetTranscript]);
+    }, [settings, tasks, contextTokens, totalCost, sessionTitle, exit, pushRow, getAgent, switchModel, resetTranscript, clearQueue]);
     const handleSubmit = useCallback((value) => {
         if (value.startsWith("/")) {
             handleCommand(value);
@@ -537,11 +580,18 @@ export function App({ initialView, initialPrompt, initialSession, }) {
             setView("login");
             return;
         }
+        // While the LLM is still streaming, hold the message in a FIFO
+        // queue instead of dropping it on the floor. `handleEvent`'s
+        // `turn-end` case drains the queue and starts the next turn.
+        if (busy) {
+            enqueueMessage(value);
+            return;
+        }
         pushRow({ kind: "user", text: value });
         setBusy(true);
         setBusyLabel("Thinking");
         void getAgent().runTurn(value);
-    }, [settings.token, handleCommand, getAgent, pushRow]);
+    }, [settings, busy, handleCommand, enqueueMessage, getAgent, pushRow]);
     // Apply --resume and an initial prompt (`orbcode "do something"`) on startup.
     const bootedRef = useRef(false);
     useEffect(() => {
@@ -554,7 +604,29 @@ export function App({ initialView, initialPrompt, initialSession, }) {
             handleSubmit(initialPrompt);
         refreshUsage();
     }, [initialSession, initialPrompt, handleResume, handleSubmit, refreshUsage]);
+    // Resolve the npm version check after first paint so the TUI shows up
+    // immediately and the upgrade banner fades in once we know the answer.
+    useEffect(() => {
+        if (!updateCheck)
+            return;
+        let cancelled = false;
+        updateCheck.then((info) => {
+            if (!cancelled)
+                setUpdateInfo(info);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [updateCheck]);
     useInput((input, key) => {
+        // Ctrl+D quits from any view (chat, login, busy, picker, approval,
+        // followup). InputBox swallows other Ctrl-combos, but this hook is a
+        // sibling of InputBox's hook, so it still sees the key.
+        if (key.ctrl && input === "d") {
+            agentRef.current?.abort();
+            exit();
+            return;
+        }
         if (key.escape && busy && !pendingApproval && !pendingFollowup) {
             agentRef.current?.abort();
         }
@@ -593,8 +665,8 @@ export function App({ initialView, initialPrompt, initialSession, }) {
         pushRow({ kind: "info", text: `Signed in${who ? ` as ${who}` : ""}. Ready when you are.` });
     }, [pushRow]);
     const taskLines = useMemo(() => tasks.split("\n").map((l) => l.trim()).filter(Boolean), [tasks]);
-    const inputActive = view === "chat" && !busy && !pendingApproval && !pendingFollowup && !modelPickerOpen && !resumableSessions;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: rows, children: (row) => _jsx(RowView, { row: row }, row.id) }, staticKey), view === "login" ? (_jsx(LoginSection, { onLogin: handleLogin })) : (_jsxs(Box, { flexDirection: "column", children: [streamingReasoning && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: COLORS.thinking, italic: true, children: "\u2726 Thinking\u2026" }), _jsx(Box, { paddingLeft: 2, children: _jsx(Text, { dimColor: true, italic: true, children: tail(streamingReasoning, expandReasoningRef.current ? 30 : 3) }) })] })), streamingText && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: COLORS.primary, children: "\u25CF " }), streamingText] }) })), runningTool && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: COLORS.warning, children: [formatToolName(runningTool.name), " ", _jsx(Text, { dimColor: true, children: runningTool.summary })] }) })), taskLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 1, children: [_jsx(Text, { dimColor: true, bold: true, children: "Tasks" }), taskLines.slice(0, 10).map((line, i) => (_jsx(Text, { dimColor: /^[-*]\s*\[x\]/i.test(line), children: line
+    const inputActive = view === "chat" && !pendingApproval && !pendingFollowup && !modelPickerOpen && !resumableSessions;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: rows, children: (row) => _jsx(RowView, { row: row }, row.id) }, staticKey), view === "login" ? (_jsx(LoginSection, { onLogin: handleLogin })) : (_jsxs(Box, { flexDirection: "column", children: [updateInfo?.updateAvailable && updateInfo.latest && (_jsxs(Box, { marginTop: 1, flexDirection: "column", borderStyle: "round", borderColor: COLORS.warning, paddingX: 2, alignSelf: "flex-start", children: [_jsxs(Text, { color: COLORS.warning, bold: true, children: ["\u2191 Update available: v", updateInfo.current, " \u2192 v", updateInfo.latest] }), _jsxs(Text, { children: ["Run ", _jsx(Text, { color: COLORS.accent, children: "orbcode update" }), " to install the latest version, then relaunch."] })] })), streamingReasoning && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: COLORS.thinking, italic: true, children: "\u2726 Thinking\u2026" }), _jsx(Box, { paddingLeft: 2, children: _jsx(Text, { dimColor: true, italic: true, children: tail(streamingReasoning, expandReasoningRef.current ? 30 : 3) }) })] })), streamingText && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: COLORS.primary, children: "\u25CF " }), streamingText] }) })), runningTool && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: COLORS.warning, children: [formatToolName(runningTool.name), " ", _jsx(Text, { dimColor: true, children: runningTool.summary })] }) })), taskLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 1, children: [_jsx(Text, { dimColor: true, bold: true, children: "Tasks" }), taskLines.slice(0, 10).map((line, i) => (_jsx(Text, { dimColor: /^[-*]\s*\[x\]/i.test(line), children: line
                                     .replace(/^[-*]\s*\[x\]/i, "  ■")
                                     .replace(/^[-*]\s*\[-\]/, "  ◧")
                                     .replace(/^[-*]\s*\[ \]/, "  □") }, i))), taskLines.length > 10 && _jsxs(Text, { dimColor: true, children: [" \u2026 ", taskLines.length - 10, " more"] })] })), modelPickerOpen && (_jsx(Box, { marginTop: 1, children: _jsx(ModelPicker, { currentId: settings.model, onSelect: (modelId) => {
@@ -607,12 +679,18 @@ export function App({ initialView, initialPrompt, initialSession, }) {
                                 pushRow({ kind: "user", text: answer });
                                 pendingFollowup.resolve(answer);
                                 setPendingFollowup(null);
-                            } }) })), busy && !pendingApproval && !pendingFollowup && !streamingText && (_jsx(Box, { marginTop: 1, children: _jsx(Spinner, { label: busyLabel }) })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(InputBox, { active: inputActive, slashCommands: SLASH_COMMANDS, onSubmit: handleSubmit }), _jsx(StatusBar, { modelId: settings.model, contextTokens: contextTokens, totalCost: totalCost, state: busy ? busyLabel : "", approvalMode: approvalMode, busy: busy, title: sessionTitle, plan: usage?.plan, usagePercentage: usage?.usagePercentage, tieredUsage: usage?.tieredUsage })] })] }))] }));
+                            } }) })), busy && !pendingApproval && !pendingFollowup && !streamingText && (_jsx(Box, { marginTop: 1, children: _jsx(Spinner, { label: busyLabel }) })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [queuedMessages.length > 0 && (_jsxs(Box, { flexDirection: "column", paddingLeft: 1, marginBottom: 1, children: [_jsxs(Text, { dimColor: true, bold: true, children: ["Queue (", queuedMessages.length, ")"] }), queuedMessages.slice(0, 5).map((msg, i) => (_jsxs(Text, { dimColor: true, children: [i + 1, ". ", truncateForQueue(msg).replace(/\n/g, "↵")] }, i))), queuedMessages.length > 5 && (_jsxs(Text, { dimColor: true, children: [" \u2026 ", queuedMessages.length - 5, " more"] }))] })), _jsx(InputBox, { active: inputActive, slashCommands: SLASH_COMMANDS, onSubmit: handleSubmit }), _jsx(StatusBar, { modelId: settings.model, contextTokens: contextTokens, totalCost: totalCost, state: busy ? busyLabel : "", approvalMode: approvalMode, busy: busy, title: sessionTitle, plan: usage?.plan, usagePercentage: usage?.usagePercentage, tieredUsage: usage?.tieredUsage })] })] }))] }));
 }
 function tail(text, lines) {
     const all = text.split("\n").filter((l) => l.trim());
     return all.slice(-lines).join("\n");
 }
+const QUEUE_PREVIEW_LIMIT = 80;
+function truncateForQueue(text) {
+    if (text.length <= QUEUE_PREVIEW_LIMIT)
+        return text;
+    return text.slice(0, QUEUE_PREVIEW_LIMIT - 1) + "…";
+}
 function LoginSection({ onLogin }) {
     return _jsx(LoginView, { onLogin: onLogin });
 }

package/dist/ui/components/InputBox.js

@@ -147,6 +147,14 @@ export function InputBox({ active, slashCommands, onSubmit }) {
                 return;
             }
         }
+        if (key.shift && key.return) {
+            // Shift+Enter inserts a literal newline without submitting.
+            setHistoryIndex(-1);
+            const next = value.slice(0, cursor) + "\n" + value.slice(cursor);
+            setValue(next);
+            setCursor((c) => c + 1);
+            return;
+        }
         if (key.return) {
             submit(value);
             return;
@@ -198,15 +206,11 @@ export function InputBox({ active, slashCommands, onSubmit }) {
             return;
         }
         if (input) {
-            // Multi-char chunks (paste) can carry an embedded trailing newline,
-            // which should submit like pressing Enter.
-            const endsWithNewline = /[\r\n]$/.test(input);
-            const clean = input.replace(/[\r\n]+$/, "").replace(/\r/g, "\n");
+            // Multi-char chunks (paste) are inserted as-is. Newlines inside
+            // the chunk are literal newlines, not a submit signal — press
+            // Enter when you're ready to send.
+            const clean = input.replace(/\r\n?/g, "\n");
             const next = value.slice(0, cursor) + clean + value.slice(cursor);
-            if (endsWithNewline) {
-                submit(next);
-                return;
-            }
             setHistoryIndex(-1);
             setValue(next);
             setCursor((c) => c + clean.length);

package/dist/utils/updateCheck.js

@@ -0,0 +1,162 @@
+import { execFile, spawn } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { promisify } from "node:util";
+import { getConfigDir } from "../config/settings.js";
+const execFileAsync = promisify(execFile);
+/** Network timeout when hitting the npm registry. Kept short so it never blocks startup. */
+const REGISTRY_TIMEOUT_MS = 3_000;
+/** Don't re-hit npm more than once per TTL window. */
+const CACHE_TTL_MS = 60 * 60 * 1_000; // 1 hour
+/** Hit the npm registry to learn what the latest published version is. */
+export async function fetchLatestNpmVersion(pkg, timeoutMs = REGISTRY_TIMEOUT_MS) {
+    // encodeURIComponent turns "@matterailab/orbcode" into "@matterailab%2Forbcode",
+    // which is the form the registry URL expects for scoped packages.
+    const url = `https://registry.npmjs.org/${encodeURIComponent(pkg)}/latest`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            signal: controller.signal,
+            headers: { accept: "application/json" },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return typeof data.version === "string" ? data.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Compare two semver strings (X.Y.Z, optionally with a pre-release suffix).
+ * Returns -1 if a < b, 0 if equal, 1 if a > b. Non-numeric segments fall back
+ * to lexicographic compare so "0.1.4-beta" sorts before "0.1.4".
+ */
+export function compareVersions(a, b) {
+    const [aMain, aPre] = splitVersion(a);
+    const [bMain, bPre] = splitVersion(b);
+    for (let i = 0; i < 3; i++) {
+        const ai = aMain[i] ?? 0;
+        const bi = bMain[i] ?? 0;
+        if (ai !== bi)
+            return ai < bi ? -1 : 1;
+    }
+    // A version with no pre-release is greater than one with one.
+    if (aPre === bPre)
+        return 0;
+    if (aPre === "")
+        return 1;
+    if (bPre === "")
+        return -1;
+    return aPre < bPre ? -1 : 1;
+}
+function splitVersion(v) {
+    const [main, pre = ""] = v.split("-", 2);
+    const parts = main.split(".").map((p) => {
+        const n = Number.parseInt(p, 10);
+        return Number.isFinite(n) ? n : 0;
+    });
+    while (parts.length < 3)
+        parts.push(0);
+    return [parts, pre];
+}
+function getCachePath() {
+    return path.join(getConfigDir(), "update-check.json");
+}
+function readCache() {
+    try {
+        const raw = fs.readFileSync(getCachePath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.checkedAt !== "number")
+            return null;
+        return { checkedAt: parsed.checkedAt, latest: parsed.latest ?? null };
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(latest) {
+    try {
+        const dir = getConfigDir();
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(getCachePath(), JSON.stringify({ checkedAt: Date.now(), latest }), { mode: 0o600 });
+    }
+    catch {
+        // best-effort; a missing cache just means we'll hit the registry again next launch
+    }
+}
+/**
+ * Resolve whether a newer version is available, using a short-lived cache so
+ * we don't hammer the npm registry on every launch.
+ */
+export async function getUpdateInfo(pkg, current) {
+    const cached = readCache();
+    if (cached && Date.now() - cached.checkedAt < CACHE_TTL_MS) {
+        return makeResult(current, cached.latest);
+    }
+    const latest = await fetchLatestNpmVersion(pkg);
+    if (latest !== null)
+        writeCache(latest);
+    return makeResult(current, latest);
+}
+function makeResult(current, latest) {
+    if (latest === null) {
+        return { current, latest: null, updateAvailable: false, unknown: true };
+    }
+    return {
+        current,
+        latest,
+        updateAvailable: compareVersions(current, latest) < 0,
+        unknown: false,
+    };
+}
+/** Invalidate the cached "latest" so the next launch re-checks. */
+export function clearUpdateCache() {
+    try {
+        fs.unlinkSync(getCachePath());
+    }
+    catch {
+        // ignore
+    }
+}
+/** Run `npm install -g <pkg>@latest` and return the exit code (0 = success). */
+export function runNpmUpdate(pkg) {
+    return new Promise((resolve) => {
+        // On Windows, npm is a .cmd shim; spawning it directly fails without shell:true.
+        const isWin = process.platform === "win32";
+        const child = spawn("npm", ["install", "-g", `${pkg}@latest`], {
+            stdio: "inherit",
+            shell: isWin,
+        });
+        child.on("error", () => resolve(1));
+        child.on("close", (code) => resolve(typeof code === "number" ? code : 1));
+    });
+}
+/**
+ * Detect whether the running CLI is inside a global npm install, so the
+ * update command can surface a friendlier message for local/dev installs.
+ */
+export function isGlobalInstall() {
+    // When installed via `npm i -g @matterailab/orbcode`, the entrypoint lives
+    // somewhere like <global root>/node_modules/@matterailab/orbcode/...
+    const here = process.argv[1] || "";
+    return /node_modules[\\/]@matterailab[\\/]orbcode/.test(here);
+}
+/** Best-effort: run `npm root -g` so we can show the install location. */
+export async function getGlobalInstallRoot() {
+    try {
+        const { stdout } = await execFileAsync("npm", ["root", "-g"], {
+            shell: process.platform === "win32",
+        });
+        const trimmed = stdout.trim();
+        return trimmed ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterailab/orbcode",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "OrbCode CLI — agentic coding in your terminal, powered by Axon models by MatterAI",
   "type": "module",
   "bin": {
@@ -40,7 +40,7 @@
     "ink": "^5.2.1",
     "open": "^10.1.0",
     "openai": "^4.78.0",
-    "picomatch": "^4.0.2",
+    "picomatch": "^4.0.4",
     "react": "^18.3.1"
   },
   "devDependencies": {