@songsid/agend 2.1.0-beta.17 → 2.1.0-beta.18

package/README.md

@@ -121,6 +121,7 @@ graph LR
 | OpenCode | `curl -fsSL https://opencode.ai/install \| bash` | `opencode` (configure provider) |
 | Kiro CLI | `curl -fsSL https://cli.kiro.dev/install | bash` | `kiro-cli login` (AWS Builder ID) |
 | Antigravity CLI | `curl -fsSL https://antigravity.google/cli/install.sh \| bash` | `agy` (Google Sign-In) |
+| Grok Build | `curl -fsSL https://x.ai/cli/install.sh \| bash` | `grok` (x.ai OAuth device flow) ⚠️ Experimental |
 
 ## Requirements
 

package/dist/backend/factory.js

@@ -4,6 +4,7 @@ import { CodexBackend } from "./codex.js";
 import { OpenCodeBackend } from "./opencode.js";
 import { KiroBackend } from "./kiro.js";
 import { AntigravityBackend } from "./antigravity.js";
+import { GrokBackend } from "./grok.js";
 import { MockBackend } from "./mock.js";
 export function createBackend(name, instanceDir) {
     switch (name) {
@@ -20,10 +21,13 @@ export function createBackend(name, instanceDir) {
             return new KiroBackend(instanceDir);
         case "antigravity":
             return new AntigravityBackend(instanceDir);
+        case "grok":
+            console.warn("⚠️ grok backend is experimental — some patterns may need tuning.");
+            return new GrokBackend(instanceDir);
         case "mock":
             return new MockBackend(instanceDir);
         default:
-            throw new Error(`Unknown backend: ${name}. Available: claude-code, gemini-cli, codex, opencode, kiro-cli, antigravity, mock`);
+            throw new Error(`Unknown backend: ${name}. Available: claude-code, gemini-cli, codex, opencode, kiro-cli, antigravity, grok, mock`);
     }
 }
 //# sourceMappingURL=factory.js.map

package/dist/backend/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/backend/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAmB;IAC7D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC5C,KAAK,YAAY;YACf,OAAO,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;YAC5G,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,UAAU;YACb,OAAO,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;QAC1C,KAAK,UAAU;YACb,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC,KAAK,aAAa;YAChB,OAAO,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC7C,KAAK,MAAM;YACT,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,oFAAoF,CAAC,CAAC;IAClI,CAAC;AACH,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/backend/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAmB;IAC7D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC5C,KAAK,YAAY;YACf,OAAO,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;YAC5G,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,UAAU;YACb,OAAO,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;QAC1C,KAAK,UAAU;YACb,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC,KAAK,aAAa;YAChB,OAAO,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC7C,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;YACjF,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC,KAAK,MAAM;YACT,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,0FAA0F,CAAC,CAAC;IACxI,CAAC;AACH,CAAC"}

package/dist/backend/grok.d.ts

@@ -0,0 +1,40 @@
+import { type CliBackend, type CliBackendConfig, type ErrorPattern, type RuntimeDialog, type StartupDialog } from "./types.js";
+/**
+ * Grok Build (xAI) — https://docs.x.ai/build/cli
+ *
+ * IMPORTANT — why the interactive TUI, not `grok agent stdio`:
+ * Grok Build exposes three surfaces: the interactive TUI (`grok`), headless
+ * (`grok -p "<prompt>"`), and an ACP agent (`grok agent stdio`) that speaks
+ * JSON-RPC over stdin/stdout. AgEnD drives a backend through a tmux PTY — it
+ * scans human-readable pane text for ready/error patterns and injects
+ * keystrokes (cancel key, slash commands). An ACP JSON-RPC agent has no
+ * human-readable prompt, ready banner, or slash commands, so the CliBackend
+ * interface does not map onto it. The interactive TUI is the correct surface,
+ * the same choice made for codex/opencode/kiro.
+ *
+ * Phase 2: ready pattern, cancel/quit keys, /compact, context format, and the
+ * device-flow login dialog were confirmed against a live grok session. Error
+ * strings beyond the cancellation notice are still best-effort and may need
+ * tuning — the backend is registered as experimental (see factory.ts).
+ */
+export declare class GrokBackend implements CliBackend {
+    private instanceDir;
+    readonly binaryName = "grok";
+    private binaryPath;
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    /** The daemon's persisted session id (written from getSessionId()), for --resume. */
+    private storedSessionId;
+    writeConfig(config: CliBackendConfig): void;
+    getReadyPattern(): RegExp;
+    getErrorPatterns(): ErrorPattern[];
+    getStartupDialogs(): StartupDialog[];
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    getRuntimeDialogs(): RuntimeDialog[];
+    getQuitCommand(): string | null;
+    getQuitKey(): string;
+    getCompactCommand(): string;
+    getCancelKey(): string;
+    cleanup(config: CliBackendConfig): void;
+}

package/dist/backend/grok.js

@@ -0,0 +1,213 @@
+import { join } from "node:path";
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { isModelCompatible, resolveBinary, validateModel } from "./types.js";
+import { appendWithMarker, removeMarker } from "./marker-utils.js";
+/** Session ids are UUIDs (e.g. "019f82d4-…"); guard before shell interpolation. */
+const SESSION_ID_RE = /^[A-Za-z0-9-]+$/;
+/**
+ * Grok Build (xAI) — https://docs.x.ai/build/cli
+ *
+ * IMPORTANT — why the interactive TUI, not `grok agent stdio`:
+ * Grok Build exposes three surfaces: the interactive TUI (`grok`), headless
+ * (`grok -p "<prompt>"`), and an ACP agent (`grok agent stdio`) that speaks
+ * JSON-RPC over stdin/stdout. AgEnD drives a backend through a tmux PTY — it
+ * scans human-readable pane text for ready/error patterns and injects
+ * keystrokes (cancel key, slash commands). An ACP JSON-RPC agent has no
+ * human-readable prompt, ready banner, or slash commands, so the CliBackend
+ * interface does not map onto it. The interactive TUI is the correct surface,
+ * the same choice made for codex/opencode/kiro.
+ *
+ * Phase 2: ready pattern, cancel/quit keys, /compact, context format, and the
+ * device-flow login dialog were confirmed against a live grok session. Error
+ * strings beyond the cancellation notice are still best-effort and may need
+ * tuning — the backend is registered as experimental (see factory.ts).
+ */
+export class GrokBackend {
+    instanceDir;
+    binaryName = "grok";
+    binaryPath;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+        this.binaryPath = resolveBinary("grok");
+    }
+    buildCommand(config) {
+        // Flags: -m/--model, --always-approve, -r/--resume <ID>, -p/--single, --no-auto-update.
+        // --no-auto-update: an auto-update prompt on launch would corrupt ready detection.
+        let cmd = `${this.binaryPath} --no-auto-update`;
+        // --always-approve auto-approves tool executions (documented flag). If a grok
+        // build ignores it, getRuntimeDialogs() auto-approves the prompt as a net.
+        if (config.skipPermissions !== false)
+            cmd += " --always-approve";
+        // Resume by explicit session id (verified: grok prints
+        // "Resume this session with: grok --resume <uuid>" on exit — there is no
+        // bare --continue that reliably resumes). The id is persisted by the daemon
+        // from getSessionId(); skip on crash recovery (skipResume) for a clean start.
+        if (!config.skipResume) {
+            const sid = this.storedSessionId();
+            if (sid)
+                cmd += ` --resume ${sid}`;
+        }
+        if (config.model) {
+            if (isModelCompatible("grok", config.model)) {
+                cmd += ` --model ${validateModel(config.model)}`;
+            }
+            else {
+                console.warn(`[agend] model "${config.model}" is not compatible with grok — skipping --model, using the CLI's default`);
+            }
+        }
+        return cmd;
+    }
+    /** The daemon's persisted session id (written from getSessionId()), for --resume. */
+    storedSessionId() {
+        try {
+            const sid = readFileSync(join(this.instanceDir, "session-id"), "utf-8").trim();
+            return SESSION_ID_RE.test(sid) ? sid : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    writeConfig(config) {
+        // Grok Build merges MCP servers from a project-level .mcp.json (loaded below
+        // ~/.grok/config.toml in priority). Using the project file means we never
+        // clobber the user's global config. Standard mcpServers format: { command, args, env }.
+        const mcpPath = join(config.workingDirectory, ".mcp.json");
+        let root = {};
+        try {
+            root = JSON.parse(readFileSync(mcpPath, "utf-8"));
+        }
+        catch { /* new file */ }
+        const servers = (root.mcpServers ?? {});
+        // Drop stale agend entries whose command binary no longer exists.
+        for (const [key, val] of Object.entries(servers)) {
+            if (key.startsWith("agend-")) {
+                const cmd = val?.command;
+                if (typeof cmd === "string" && !existsSync(cmd))
+                    delete servers[key];
+            }
+        }
+        // Namespace each server by instance so multiple instances can share a working dir.
+        for (const [name, entry] of Object.entries(config.mcpServers)) {
+            const instanceKey = `${name}-${config.instanceName}`;
+            servers[instanceKey] = {
+                command: entry.command,
+                args: entry.args,
+                env: { ...entry.env, AGEND_INSTANCE_NAME: config.instanceName },
+            };
+        }
+        // Clean up any legacy non-namespaced key.
+        delete servers["agend"];
+        root.mcpServers = servers;
+        writeFileSync(mcpPath, JSON.stringify(root, null, 2));
+        // Fleet instructions → AGENTS.md marker block (Grok reads AGENTS.md project docs,
+        // same convention as Codex). Additive + idempotent via the AGEND marker.
+        if (config.instructions) {
+            try {
+                appendWithMarker(join(config.workingDirectory, "AGENTS.md"), config.instanceName, config.instructions);
+            }
+            catch { /* best effort */ }
+        }
+    }
+    getReadyPattern() {
+        // Verified: `❯` is the idle input prompt inside the TUI box; the Grok Build
+        // header ("Grok Build" / "Grok <n>") also identifies the ready screen.
+        return /❯|Grok \d|Grok Build/m;
+    }
+    getErrorPatterns() {
+        // NOTE: "Turn cancelled by user" is NORMAL behaviour (user interrupt), not an
+        // error — none of the patterns below match it, and none should be added that do.
+        // Error strings below are best-effort generic API shapes; tune once observed live.
+        return [
+            { pattern: /rate.?limit|too many requests|\b429\b/i, type: "rate_limit", action: "failover", message: "Grok rate limit reached" },
+            { pattern: /unauthorized|authentication (failed|error)|\b401\b/i, type: "auth_error", action: "pause", message: "Grok authentication error" },
+            { pattern: /quota|insufficient credits|out of credits/i, type: "quota", action: "notify", message: "Grok quota/credits exhausted" },
+        ];
+    }
+    getStartupDialogs() {
+        return [
+            // Device-flow login is BLOCKING and cannot be auto-dismissed — the user must
+            // approve externally. Empty keys => the daemon sends nothing but treats the
+            // screen as "not ready yet" and keeps polling, so the login screen is never
+            // mistaken for the idle prompt. (The "[Click here to Upgrade]" banner is
+            // non-blocking and is intentionally NOT listed — nothing to dismiss.)
+            { pattern: /Waiting for approval|Log in to continue|device.*approval/i, keys: [], description: "Grok device-flow login — wait for user authorization (no auto-dismiss)" },
+        ];
+    }
+    getContextUsage() {
+        // Grok shows context as "12K / 500K" (used / total) in the TUI, not in a file.
+        // getContextUsage() has no pane access, so parsing lives in the pane scanners
+        // (parseContextPercent in topic-commands.ts + defaultParser in cli.ts), which
+        // is what /ctx and `agend ls` use. Nothing file-based to report here.
+        return null;
+    }
+    getSessionId() {
+        // grok stores sessions under ~/.grok/sessions/ (verified). Return the id of
+        // the most-recently-modified session so the daemon can persist it for
+        // --resume. The daemon calls this at stop/pause, right after the active
+        // session was last written, so "newest" is normally this instance's session.
+        //
+        // ⚠️ CAVEAT: ~/.grok/sessions/ is GLOBAL, not per-working-directory. If the
+        // fleet runs multiple grok instances concurrently, "newest" could belong to
+        // another instance. Correct scoping needs either per-project session storage
+        // from grok or capturing the printed "grok --resume <id>" line — see report.
+        try {
+            const dir = join(homedir(), ".grok", "sessions");
+            let newestId = null;
+            let newestMtime = -1;
+            for (const name of readdirSync(dir)) {
+                const id = name.replace(/\.[^.]+$/, ""); // strip extension if any
+                if (!SESSION_ID_RE.test(id) || id.length < 8)
+                    continue;
+                const mtime = statSync(join(dir, name)).mtimeMs;
+                if (mtime > newestMtime) {
+                    newestMtime = mtime;
+                    newestId = id;
+                }
+            }
+            return newestId;
+        }
+        catch {
+            return null;
+        }
+    }
+    getRuntimeDialogs() {
+        return [
+            // Mid-task tool-approval prompt ("1. Yes, always  2. Yes  3. No"). Select
+            // option 1 so the fleet runs unattended. Primary mechanism is
+            // --always-approve at launch; this is the net if that flag is absent/ignored.
+            // ⚠️ key needs live confirmation — assumes a numeric hotkey (types "1"+Enter);
+            // if grok uses an arrow-select cursor instead, switch to ["Enter"] or nav keys.
+            { pattern: /1\.\s*Yes,?\s*always|Yes,?\s*always[\s\S]{0,40}\bNo\b/i, keys: ["1"], description: "Grok tool-approval prompt — select 'Yes, always'" },
+        ];
+    }
+    // grok has no slash quit command — it quits via the Ctrl+Q key chord (getQuitKey).
+    getQuitCommand() { return null; }
+    getQuitKey() { return "C-q"; }
+    getCompactCommand() { return "/compact"; } // verified present
+    // Verified: grok interrupts generation on Ctrl+C.
+    getCancelKey() { return "C-c"; }
+    cleanup(config) {
+        // Remove only this instance's namespaced MCP entries — a non-namespaced key
+        // may belong to another instance sharing the working directory.
+        try {
+            const mcpPath = join(config.workingDirectory, ".mcp.json");
+            if (existsSync(mcpPath)) {
+                const root = JSON.parse(readFileSync(mcpPath, "utf-8"));
+                if (root.mcpServers) {
+                    for (const name of Object.keys(config.mcpServers)) {
+                        delete root.mcpServers[`${name}-${config.instanceName}`];
+                    }
+                    writeFileSync(mcpPath, JSON.stringify(root, null, 2));
+                }
+            }
+        }
+        catch { /* best effort */ }
+        // Remove fleet instructions marker block from AGENTS.md.
+        try {
+            removeMarker(join(config.workingDirectory, "AGENTS.md"), config.instanceName);
+        }
+        catch { /* best effort */ }
+    }
+}
+//# sourceMappingURL=grok.js.map

package/dist/backend/grok.js.map

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

package/dist/backend/types.d.ts

@@ -92,8 +92,18 @@ export interface CliBackend {
     preTrust?(workingDirectory: string): void;
     /** Resolve working directory (e.g. create symlink to avoid hidden paths). Returns resolved path. */
     resolveWorkingDirectory?(workingDirectory: string, instanceName?: string): string;
-    /** Command to gracefully quit the CLI (e.g. "/exit", "/quit"). */
-    getQuitCommand(): string;
+    /**
+     * Slash/text command to gracefully quit the CLI (e.g. "/exit", "/quit"),
+     * typed then followed by Enter. Return null when the CLI has no quit command
+     * and quits via a key chord instead — implement getQuitKey() in that case.
+     */
+    getQuitCommand(): string | null;
+    /**
+     * The tmux key chord that quits the CLI, for backends whose quit is a keypress
+     * rather than a typed command (e.g. grok Ctrl+Q). Consulted only when
+     * getQuitCommand() returns null. Values are tmux send-keys names (e.g. "C-q").
+     */
+    getQuitKey?(): string;
     /**
      * In-session command to compact/reset the conversation context. Most CLIs use
      * "/compact"; some (e.g. Codex) use "/compact" too, OpenCode uses "/compact".

package/dist/backend/types.js

@@ -34,6 +34,7 @@ const BACKEND_MODEL_PATTERNS = {
     "gemini-cli": /^gemini/i,
     "opencode": /./, // opencode accepts anything (provider-dependent)
     "antigravity": / /, // agy models always contain spaces (display names like "Gemini 3.5 Flash (High)")
+    "grok": /^grok/i, // grok-4.5, grok-4.3, grok-code, grok-build-0.1
 };
 /** Check if a model name is compatible with the given backend. */
 export function isModelCompatible(backendName, model) {

package/dist/backend/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA0IlD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,wBAAwB;IACvC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAC5C,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,aAAa,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0GAA0G;AAC1G,MAAM,sBAAsB,GAA2B;IACrD,aAAa,EAAE,4CAA4C;IAC3D,UAAU,EAAE,8BAA8B;IAC1C,OAAO,EAAE,wBAAwB;IACjC,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,GAAG,EAAG,iDAAiD;IACnE,aAAa,EAAE,GAAG,EAAG,kFAAkF;CACxG,CAAC;AAEF,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,KAAa;IAClE,MAAM,OAAO,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;IAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,KAAa;IACpE,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,kBAAkB,KAAK,uCAAuC,WAAW,0BAA0B,CAAC,CAAC;IACpH,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACzC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAqJlD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,wBAAwB;IACvC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAC5C,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,aAAa,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0GAA0G;AAC1G,MAAM,sBAAsB,GAA2B;IACrD,aAAa,EAAE,4CAA4C;IAC3D,UAAU,EAAE,8BAA8B;IAC1C,OAAO,EAAE,wBAAwB;IACjC,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,GAAG,EAAG,iDAAiD;IACnE,aAAa,EAAE,GAAG,EAAG,kFAAkF;IACvG,MAAM,EAAE,QAAQ,EAAG,gDAAgD;CACpE,CAAC;AAEF,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,KAAa;IAClE,MAAM,OAAO,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;IAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,KAAa;IACpE,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,kBAAkB,KAAK,uCAAuC,WAAW,0BAA0B,CAAC,CAAC;IACpH,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACzC,CAAC"}

package/dist/cli.js

@@ -1938,6 +1938,7 @@ function formatTimeSince(isoStr) {
  *   kiro classic "8% !>" / TUI "◔ 1%" / bracket "[8%]" / prompt "8% ❯"
  *   codex "Context N% left" (remaining → 100-N) or "Context N% used"
  *   opencode "1.2K (6%)"
+ *   grok "12K / 500K" (used tokens / context window)
  * Duplicated (not imported) so this CLI entry point stays free of the daemon's
  * dependency graph. All returned values are context USED (low % = fresh).
  */
@@ -1948,6 +1949,18 @@ const defaultParser = (output) => {
         const left = line.match(/Context\s+(\d+)%\s+left/i);
         if (left)
             return 100 - parseInt(left[1], 10);
+        const ratio = line.match(/(\d+\.?\d*[KkMm]?)\s*\/\s*(\d+\.?\d*[KkMm]?)/);
+        if (ratio) {
+            const tokenCount = (value) => {
+                const suffix = value.at(-1)?.toLowerCase();
+                const multiplier = suffix === "k" ? 1_000 : suffix === "m" ? 1_000_000 : 1;
+                return parseFloat(value) * multiplier;
+            };
+            const used = tokenCount(ratio[1]);
+            const total = tokenCount(ratio[2]);
+            if (Number.isFinite(used) && Number.isFinite(total) && total > 0)
+                return used / total * 100;
+        }
         const m = line.match(/(\d+)%.*[!❯>]/)
             || line.match(/◔\s*(\d+)%/)
             || line.match(/\[(\d+)%\]/)