@jiawang1209/codex-hud 0.1.0

package/dist/sources/session.d.ts

@@ -0,0 +1,14 @@
+import type { ProgressSnapshot, TodoSnapshot, ToolActivity } from "../types.js";
+export interface SessionSignals {
+    context?: ProgressSnapshot;
+    usage?: ProgressSnapshot;
+    weekly?: ProgressSnapshot;
+    tools: ToolActivity[];
+    todos: TodoSnapshot;
+}
+export interface ParseSessionOptions {
+    recentToolCallLimit?: number;
+}
+export declare function readLatestSessionSignals(codexHome: string, cwd?: string): Promise<SessionSignals>;
+export declare function parseSessionJsonl(text: string, options?: ParseSessionOptions): SessionSignals;
+export declare function findLatestSessionFile(sessionsDir: string, cwd?: string): Promise<string | undefined>;

package/dist/sources/session.js

@@ -0,0 +1,278 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+const DEFAULT_RECENT_TOOL_CALL_LIMIT = 12;
+export async function readLatestSessionSignals(codexHome, cwd) {
+    const sessionsDir = path.join(codexHome, "sessions");
+    const latest = await findLatestSessionFile(sessionsDir, cwd);
+    if (!latest)
+        return emptySignals();
+    try {
+        return parseSessionJsonl(await readFile(latest, "utf8"));
+    }
+    catch {
+        return emptySignals();
+    }
+}
+export function parseSessionJsonl(text, options = {}) {
+    const toolsByCall = new Map();
+    let context;
+    let usage;
+    let weekly;
+    let todos = { completed: 0, total: 0 };
+    let lineIndex = 0;
+    for (const line of text.split(/\r?\n/)) {
+        lineIndex += 1;
+        if (!line.trim())
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const payload = entry.payload;
+        if (!payload)
+            continue;
+        if (payload.type === "function_call" && payload.call_id && payload.name) {
+            toolsByCall.set(payload.call_id, {
+                name: displayToolName(payload.name),
+                status: "active",
+                lastIndex: lineIndex,
+            });
+            if (payload.name === "update_plan") {
+                todos = parseUpdatePlanTodos(payload.arguments) ?? todos;
+            }
+            continue;
+        }
+        if (isCompletionPayload(payload.type) && payload.call_id) {
+            const tool = toolsByCall.get(payload.call_id);
+            if (tool) {
+                tool.status = payload.type === "patch_apply_end" ? "completed" : "completed";
+                tool.lastIndex = lineIndex;
+            }
+            continue;
+        }
+        if (payload.type === "token_count") {
+            const totalTokens = payload.info?.last_token_usage?.total_tokens
+                ?? payload.info?.total_token_usage?.total_tokens;
+            const contextWindow = payload.info?.model_context_window;
+            if (validPositiveNumber(totalTokens) && validPositiveNumber(contextWindow)) {
+                context = {
+                    label: "Context",
+                    percent: clampPercent(Math.round((totalTokens / contextWindow) * 100)),
+                };
+            }
+            const primary = payload.rate_limits?.primary;
+            if (validPercent(primary?.used_percent)) {
+                usage = {
+                    label: formatRateLimitWindow(primary?.window_minutes),
+                    percent: primary.used_percent,
+                    windowMinutes: validPositiveNumber(primary?.window_minutes) ? primary.window_minutes : undefined,
+                };
+            }
+            const secondary = payload.rate_limits?.secondary;
+            if (validPercent(secondary?.used_percent)) {
+                const windowMinutes = validPositiveNumber(secondary?.window_minutes)
+                    ? secondary.window_minutes
+                    : undefined;
+                weekly = {
+                    label: "Weekly",
+                    percent: secondary.used_percent,
+                    windowMinutes,
+                };
+            }
+        }
+    }
+    return {
+        context,
+        usage,
+        weekly,
+        tools: summarizeTools(toolsByCall, normalizeRecentLimit(options.recentToolCallLimit)),
+        todos,
+    };
+}
+export async function findLatestSessionFile(sessionsDir, cwd) {
+    const files = await listJsonlFiles(sessionsDir);
+    if (files.length === 0)
+        return undefined;
+    const targetCwd = cwd ? normalizePath(cwd) : undefined;
+    let latest;
+    let latestMatching;
+    for (const file of files) {
+        try {
+            const info = await stat(file);
+            if (!latest || info.mtimeMs > latest.mtimeMs || (info.mtimeMs === latest.mtimeMs && file > latest.file)) {
+                latest = { file, mtimeMs: info.mtimeMs };
+            }
+            if (targetCwd && await sessionFileMatchesCwd(file, targetCwd)) {
+                if (!latestMatching
+                    || info.mtimeMs > latestMatching.mtimeMs
+                    || (info.mtimeMs === latestMatching.mtimeMs && file > latestMatching.file)) {
+                    latestMatching = { file, mtimeMs: info.mtimeMs };
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return latestMatching?.file ?? latest?.file;
+}
+function emptySignals() {
+    return {
+        tools: [],
+        todos: { completed: 0, total: 0 },
+    };
+}
+async function listJsonlFiles(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...await listJsonlFiles(fullPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+function isCompletionPayload(type) {
+    return type === "function_call_output"
+        || type === "custom_tool_call_output"
+        || type === "mcp_tool_call_end"
+        || type === "patch_apply_end";
+}
+function summarizeTools(toolsByCall, recentToolCallLimit) {
+    const byName = new Map();
+    const recentTools = Array.from(toolsByCall.values())
+        .sort((a, b) => b.lastIndex - a.lastIndex)
+        .slice(0, recentToolCallLimit);
+    for (const tool of recentTools) {
+        const current = byName.get(tool.name) ?? { active: 0, completed: 0, lastIndex: 0 };
+        if (tool.status === "active")
+            current.active += 1;
+        else
+            current.completed += 1;
+        current.lastIndex = Math.max(current.lastIndex, tool.lastIndex);
+        byName.set(tool.name, current);
+    }
+    return Array.from(byName.entries())
+        .sort((a, b) => b[1].lastIndex - a[1].lastIndex)
+        .slice(0, 4)
+        .reverse()
+        .map(([name, counts]) => ({
+        name,
+        status: counts.active > 0 ? "active" : "completed",
+        count: counts.active + counts.completed,
+    }));
+}
+function normalizeRecentLimit(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+        return DEFAULT_RECENT_TOOL_CALL_LIMIT;
+    }
+    return Math.min(value, 100);
+}
+function parseUpdatePlanTodos(argumentsJson) {
+    if (!argumentsJson)
+        return undefined;
+    try {
+        const parsed = JSON.parse(argumentsJson);
+        if (!Array.isArray(parsed.plan))
+            return undefined;
+        const total = parsed.plan.length;
+        const completed = parsed.plan.filter((item) => item.status === "completed").length;
+        const current = parsed.plan.find((item) => item.status === "in_progress")?.step;
+        return {
+            completed,
+            total,
+            current: typeof current === "string" ? current : undefined,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function displayToolName(name) {
+    const normalized = name.split(".").pop() ?? name;
+    const known = {
+        exec_command: "Exec",
+        write_stdin: "Stdin",
+        update_plan: "Plan",
+        apply_patch: "Patch",
+        view_image: "Image",
+        js: "Node",
+    };
+    if (known[normalized])
+        return known[normalized];
+    return normalized
+        .replace(/[_-]+/g, " ")
+        .replace(/\b\w/g, (char) => char.toUpperCase())
+        .replace(/\s+/g, "");
+}
+function formatRateLimitWindow(windowMinutes) {
+    if (!validPositiveNumber(windowMinutes))
+        return "Usage";
+    if (windowMinutes % 1440 === 0)
+        return `${windowMinutes / 1440}d`;
+    if (windowMinutes % 60 === 0)
+        return `${windowMinutes / 60}h`;
+    return `${windowMinutes}m`;
+}
+function validPositiveNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function validPercent(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 && value <= 100;
+}
+function clampPercent(value) {
+    return Math.min(100, Math.max(0, value));
+}
+async function sessionFileMatchesCwd(file, targetCwd) {
+    const sessionCwd = await readSessionCwd(file);
+    if (!sessionCwd)
+        return false;
+    return pathsOverlap(normalizePath(sessionCwd), targetCwd);
+}
+async function readSessionCwd(file) {
+    let text;
+    try {
+        text = await readFile(file, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    for (const line of text.split(/\r?\n/).slice(0, 80)) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            if ((entry.type === "session_meta" || entry.type === "turn_context") && typeof entry.payload?.cwd === "string") {
+                return entry.payload.cwd;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+function normalizePath(value) {
+    return path.resolve(value);
+}
+function pathsOverlap(sessionCwd, targetCwd) {
+    return sessionCwd === targetCwd || isWithin(sessionCwd, targetCwd) || isWithin(targetCwd, sessionCwd);
+}
+function isWithin(candidate, parent) {
+    const relative = path.relative(parent, candidate);
+    return relative.length > 0 && !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+//# sourceMappingURL=session.js.map

package/dist/sources/session.js.map

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

package/dist/tmux-runner.d.ts

@@ -0,0 +1,26 @@
+export type TerminalLauncher = "tmux" | "iterm" | "terminal";
+export interface RunOptions {
+    codexArgs: string[];
+    dryRun: boolean;
+    height: number;
+    sessionName: string;
+    terminal: TerminalLauncher;
+}
+export interface TmuxCommandOptions {
+    cwd: string;
+    codexArgs?: string[];
+    height?: number;
+    sessionName: string;
+}
+export declare function parseRunArgs(args: string[]): RunOptions;
+export declare function runCodexHudSession(options: RunOptions, cwd?: string): Promise<number>;
+export declare function dryRunText(options: RunOptions, cwd: string): string;
+export declare function tmuxLaunchCommands(options: RunOptions, cwd: string): string[][];
+export declare function buildTmuxNewSessionArgs(options: TmuxCommandOptions): string[];
+export declare function buildTmuxSplitArgs(options: TmuxCommandOptions & {
+    targetPane?: string;
+}): string[];
+export declare function buildTmuxAttachArgs(sessionName: string): string[];
+export declare function buildITermAppleScript(options: TmuxCommandOptions): string;
+export declare function buildMacTerminalAppleScript(options: TmuxCommandOptions): string;
+export declare function shellQuote(value: string): string;

package/dist/tmux-runner.js

@@ -0,0 +1,203 @@
+import { spawn, spawnSync } from "node:child_process";
+import process from "node:process";
+const DEFAULT_HEIGHT = 4;
+export function parseRunArgs(args) {
+    const separatorIndex = args.indexOf("--");
+    const wrapperArgs = separatorIndex === -1 ? args : args.slice(0, separatorIndex);
+    const codexArgs = separatorIndex === -1 ? [] : args.slice(separatorIndex + 1);
+    let dryRun = false;
+    let height = DEFAULT_HEIGHT;
+    let sessionName = `codex-hud-${Date.now()}`;
+    let terminal = "tmux";
+    for (let index = 0; index < wrapperArgs.length; index += 1) {
+        const arg = wrapperArgs[index];
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg === "--height" && wrapperArgs[index + 1]) {
+            height = normalizeHeight(Number(wrapperArgs[index + 1]));
+            index += 1;
+            continue;
+        }
+        if (arg === "--session" && wrapperArgs[index + 1]) {
+            sessionName = sanitizeSessionName(wrapperArgs[index + 1]);
+            index += 1;
+            continue;
+        }
+        if (arg === "--terminal" && wrapperArgs[index + 1]) {
+            terminal = parseTerminal(wrapperArgs[index + 1]);
+            index += 1;
+        }
+    }
+    return {
+        codexArgs,
+        dryRun,
+        height,
+        sessionName,
+        terminal,
+    };
+}
+export async function runCodexHudSession(options, cwd = process.cwd()) {
+    if (options.dryRun) {
+        process.stdout.write(`${dryRunText(options, cwd)}\n`);
+        return 0;
+    }
+    if (options.terminal === "iterm") {
+        return await runAppleScript(buildITermAppleScript({ cwd, codexArgs: options.codexArgs, sessionName: options.sessionName }));
+    }
+    if (options.terminal === "terminal") {
+        return await runAppleScript(buildMacTerminalAppleScript({
+            cwd,
+            codexArgs: options.codexArgs,
+            sessionName: options.sessionName,
+        }));
+    }
+    if (!commandExists("tmux")) {
+        process.stderr.write("codex-hud: tmux is required for `codex-hud run`\n");
+        process.stderr.write("codex-hud: install tmux, or use `codex-hud status` and `codex` separately.\n");
+        return 1;
+    }
+    if (process.env.TMUX) {
+        await spawnInherited("tmux", buildTmuxSplitArgs({
+            cwd,
+            height: options.height,
+            sessionName: "",
+            targetPane: undefined,
+        }));
+        return await spawnInherited("codex", options.codexArgs);
+    }
+    for (const args of tmuxLaunchCommands(options, cwd)) {
+        const code = await spawnInherited("tmux", args);
+        if (code !== 0)
+            return code;
+    }
+    return 0;
+}
+export function dryRunText(options, cwd) {
+    if (options.terminal === "iterm") {
+        return `osascript <<'APPLESCRIPT'\n${buildITermAppleScript({
+            cwd,
+            codexArgs: options.codexArgs,
+            sessionName: options.sessionName,
+        })}\nAPPLESCRIPT`;
+    }
+    if (options.terminal === "terminal") {
+        return `osascript <<'APPLESCRIPT'\n${buildMacTerminalAppleScript({
+            cwd,
+            codexArgs: options.codexArgs,
+            sessionName: options.sessionName,
+        })}\nAPPLESCRIPT`;
+    }
+    const commands = tmuxLaunchCommands(options, cwd);
+    return commands.map((command) => `tmux ${command.map(shellQuote).join(" ")}`).join("\n");
+}
+export function tmuxLaunchCommands(options, cwd) {
+    return [
+        buildTmuxNewSessionArgs({ cwd, codexArgs: options.codexArgs, sessionName: options.sessionName }),
+        buildTmuxSplitArgs({ cwd, height: options.height, sessionName: options.sessionName }),
+        ["select-pane", "-t", `${options.sessionName}:0.0`],
+        buildTmuxAttachArgs(options.sessionName),
+    ];
+}
+export function buildTmuxNewSessionArgs(options) {
+    return [
+        "new-session",
+        "-d",
+        "-s",
+        options.sessionName,
+        "-c",
+        options.cwd,
+        ["codex", ...(options.codexArgs ?? [])].map(shellQuote).join(" "),
+    ];
+}
+export function buildTmuxSplitArgs(options) {
+    const args = [
+        "split-window",
+        "-v",
+        "-l",
+        String(options.height ?? DEFAULT_HEIGHT),
+    ];
+    const target = options.targetPane ?? (options.sessionName ? `${options.sessionName}:0.0` : undefined);
+    if (target) {
+        args.push("-t", target);
+    }
+    args.push("-c", options.cwd, "codex-hud pane");
+    return args;
+}
+export function buildTmuxAttachArgs(sessionName) {
+    return ["attach-session", "-t", sessionName];
+}
+export function buildITermAppleScript(options) {
+    const codexCommand = shellCommand(options.cwd, ["codex", ...(options.codexArgs ?? [])]);
+    const hudCommand = shellCommand(options.cwd, ["codex-hud", "pane"]);
+    return [
+        'tell application "iTerm2"',
+        "  activate",
+        "  set newWindow to (create window with default profile)",
+        "  tell current session of newWindow",
+        `    write text ${appleScriptString(codexCommand)}`,
+        "    set hudSession to (split horizontally with default profile)",
+        "  end tell",
+        "  tell hudSession",
+        `    write text ${appleScriptString(hudCommand)}`,
+        "  end tell",
+        "end tell",
+    ].join("\n");
+}
+export function buildMacTerminalAppleScript(options) {
+    const codexCommand = shellCommand(options.cwd, ["codex", ...(options.codexArgs ?? [])]);
+    const hudCommand = shellCommand(options.cwd, ["codex-hud", "pane"]);
+    return [
+        'tell application "Terminal"',
+        "  activate",
+        `  do script ${appleScriptString(codexCommand)}`,
+        `  do script ${appleScriptString(hudCommand)}`,
+        "end tell",
+    ].join("\n");
+}
+export function shellQuote(value) {
+    if (/^[A-Za-z0-9_./:=@%+-]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function commandExists(command) {
+    const result = spawnSync(command, ["-V"], { encoding: "utf8", stdio: "ignore" });
+    return result.status === 0;
+}
+function spawnInherited(command, args) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { stdio: "inherit" });
+        child.on("error", () => resolve(1));
+        child.on("exit", (code) => resolve(code ?? 1));
+    });
+}
+function runAppleScript(script) {
+    return new Promise((resolve) => {
+        const child = spawn("osascript", [], { stdio: ["pipe", "inherit", "inherit"] });
+        child.stdin.end(script);
+        child.on("error", () => resolve(1));
+        child.on("exit", (code) => resolve(code ?? 1));
+    });
+}
+function normalizeHeight(value) {
+    if (!Number.isInteger(value) || value < 3)
+        return DEFAULT_HEIGHT;
+    return Math.min(value, 12);
+}
+function sanitizeSessionName(value) {
+    const sanitized = value.replace(/[^A-Za-z0-9_.-]+/g, "-").replace(/^-+|-+$/g, "");
+    return sanitized || `codex-hud-${Date.now()}`;
+}
+function parseTerminal(value) {
+    if (value === "iterm" || value === "terminal" || value === "tmux")
+        return value;
+    return "tmux";
+}
+function shellCommand(cwd, command) {
+    return `cd ${shellQuote(cwd)} && ${command.map(shellQuote).join(" ")}`;
+}
+function appleScriptString(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=tmux-runner.js.map

package/dist/tmux-runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+export interface ProgressSnapshot {
+    label: string;
+    percent: number;
+    windowMinutes?: number;
+}
+export interface GitSnapshot {
+    branch: string;
+    isDirty: boolean;
+    ahead: number;
+    behind: number;
+}
+export interface ToolActivity {
+    name: string;
+    status: "active" | "completed" | "error";
+    count?: number;
+}
+export interface TodoSnapshot {
+    completed: number;
+    total: number;
+    current?: string;
+}
+export interface SessionSnapshot {
+    name?: string;
+    duration?: string;
+}
+export interface HudWarning {
+    message: string;
+}
+export interface HudSnapshot {
+    model?: string;
+    reasoningEffort?: string;
+    cwd: string;
+    projectName: string;
+    git?: GitSnapshot;
+    context?: ProgressSnapshot;
+    usage?: ProgressSnapshot;
+    weekly?: ProgressSnapshot;
+    tools: ToolActivity[];
+    todos: TodoSnapshot;
+    session?: SessionSnapshot;
+    warnings: HudWarning[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/docs/installation.md

@@ -0,0 +1,42 @@
+# Installation
+
+## Recommended Native HUD
+
+```bash
+npm install -g @jiawang1209/codex-hud
+codex-hud install
+codex
+```
+
+`codex-hud install` prepares the complete native bundle:
+
+- downloads a clean Codex CLI source checkout under `~/.codex-hud/native/openai-codex`
+- applies the bundled command-backed status-line patch
+- builds the patched Codex binary
+- installs a reversible `codex` shim in `~/.local/bin`
+
+After that, users run `codex` normally and Codex HUD is injected into the native Codex footer.
+
+## Verify
+
+```bash
+codex-hud doctor
+```
+
+The doctor output should report the `codex-hud` binary, `codex` shim, patched Codex binary, and native status command.
+
+## Custom Paths
+
+```bash
+codex-hud install --codex-source ~/src/openai-codex --bin-dir ~/.local/bin
+```
+
+Use this when you already keep a Codex source checkout somewhere else or need a custom shim directory.
+
+## Fallback Without Native Adapter
+
+```bash
+codex-hud run
+```
+
+This opens Codex with an external HUD pane using tmux, iTerm2, or Terminal.app. It does not require the patched Codex native adapter.