greprag 5.21.0 → 5.22.1

package/README.md

@@ -1,47 +1,90 @@
 # GrepRAG
 
-Agent memory as a service. Episodic project memory for Claude Code and OpenCode — auto-captures turns, compacts into hourly/daily/weekly summaries, and exposes two access patterns: lexical search by topic (`greprag memory search "<query>"`) or a SessionStart-shaped recap (`greprag memory recap`). The memory product line is marketed as **Odyssey**. Also handles cross-project async messaging via inbox.
+Agent memory as a service. Episodic project memory for Claude Code, Codex, and OpenCode — captures supported agent turns, compacts into hourly/daily/weekly summaries, and exposes two access patterns: lexical search by topic (`greprag memory search "<query>"`) or a session recap (`greprag memory recap`). The memory product line is marketed as **Odyssey**. Also handles cross-project async messaging via inbox.
 
-## Quick start (both clients)
+## Quick Start
 
 ```bash
 npm i -g greprag
 ```
 
+Then either run `/greprag` inside a supported agent, or run `greprag init` in a terminal. Bare `greprag init` detects Claude Code, Codex, and OpenCode; if more than one is present in a non-interactive shell, it prints the explicit command to use.
+
 ### Claude Code
 
 Run `/greprag` in any Claude Code session, or:
 
 ```bash
-greprag init       # set up hooks + anchor + skill
+greprag init --claude
+```
+
+### Codex
+
+Run `/greprag` in Codex after install, or:
+
+```bash
+greprag init --codex --tenant-id <your-handle> --install-watcher
+```
+
+Example: `greprag init --codex --tenant-id tanya --install-watcher`.
+The handle becomes your public GrepRAG address, such as
+`tanya@greprag.com`.
+
+Codex requires one extra trust step: after init/update, open Codex Desktop
+Settings -> Settings -> Hooks, trust the 6 GrepRAG hooks, then start a fresh
+session.
+
+If you did not pass `--install-watcher`, install the login watcher later:
+
+```bash
+greprag codex startup install
 ```
 
+Run `greprag codex doctor` to verify the hook file, current Codex thread, and
+startup watcher. For foreground
+testing, run:
+
+```bash
+greprag codex watch --session <8hex-or-full-codex-session-id>
+```
+
+If `--session` is omitted, GrepRAG uses the latest Codex session. The watcher
+wakes Codex with `codex exec resume` when messages arrive.
+
 ### OpenCode
 
 ```bash
 greprag init --opencode
 ```
 
-This creates a project anchor in `.opencode/project.json` and installs the memory plugin at `~/.config/opencode/plugins/greprag-memory.js`. The plugin automatically injects the memory recap at session start and stores every turn. No agent cooperation needed.
+This installs the memory plugin at `~/.config/opencode/plugins/greprag-memory.js`.
+
+All platforms share project identity through `.greprag/project.json` when a file anchor is needed, or git-derived identity when available. Legacy `.claude/project.json` anchors still read and migrate on init.
 
-Status check (works for both):
+Status check:
 
 ```bash
-greprag status     # check what's configured
+greprag status --all-platforms
 ```
 
 ## What's active
 
-- **Memory** (episodic project memory, marketed as Odyssey): every turn captured via Stop hook, compacted into hourly/daily/weekly summaries. Query via `greprag memory search "<query>"` (lexical retrieval, v5 RRF+adjacency pipeline) or `recap` / `daily` / `weekly` / `hourly` / `turns` / `ships` (by time window). (`greprag memory briefing` and `greprag odyssey ...` are silent back-compat aliases.)
-- **SessionStart recap**: injects recent memory rows at the start of each session
+- **Memory** (episodic project memory, marketed as Odyssey): supported agent turns captured via platform hooks/plugin, compacted into hourly/daily/weekly summaries. Query via `greprag memory search "<query>"` (lexical retrieval, v5 RRF+adjacency pipeline) or `recap` / `daily` / `weekly` / `hourly` / `turns` / `ships` (by time window). (`greprag memory briefing` and `greprag odyssey ...` are silent back-compat aliases.)
+- **Memory recap**: surfaces recent memory rows through platform hooks or `/greprag`
 - **Inbox**: cross-project async messaging between your projects or other GrepRAG users
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `greprag status` | Check auth, hooks, project anchor |
-| `greprag init` | Configure hooks + anchor in current repo |
+| `greprag status --all-platforms` | Check auth, hooks/plugins, skills, and project anchor |
+| `greprag init` | Detect/ask which agent to configure |
+| `greprag init --claude` | Configure Claude Code hooks + skill |
+| `greprag init --codex --tenant-id <handle> --install-watcher` | Configure Codex hooks + skill + live watcher |
+| `greprag codex watch --session <id>` | Live-push inbox messages into Codex |
+| `greprag codex doctor` | Diagnose Codex hooks, session id, trust path, and watcher state |
+| `greprag codex startup install` | Start the Codex live watcher at login |
+| `greprag init --opencode` | Configure OpenCode plugin |
 | `greprag init --global` | Global anchor for ephemeral sessions |
 | `greprag doctor` | Diagnose project_id drift and orphan consolidation |
 | `greprag memory search "<query>"` | Lexical search over the project's memory (v5 RRF+adjacency pipeline) |
@@ -55,12 +98,12 @@ greprag status     # check what's configured
 ## Requirements
 
 - Node.js 18+
-- Claude Code (the `/greprag` skill handles setup)
-- An API key (generated during email signup in the skill flow)
+- Claude Code, Codex, or OpenCode
+- A GrepRAG handle or API key. `--tenant-id <handle>` provisions the key.
 
 ## How it works
 
-The CLI is a thin HTTP client. All intelligence — keyword extraction, dedup, scoring, compaction, graduation — lives server-side. The hook fires on Stop/SessionStart, calls the API, and the server handles everything else.
+The CLI is a thin HTTP client. All intelligence — scoring, compaction, and retrieval — lives server-side. Platform hooks/plugins call the API; the server handles everything else.
 
 ## Links
 

package/dist/codex-steering.d.ts

@@ -0,0 +1,29 @@
+export interface CodexSteeringInput {
+    session_id?: string;
+    cwd?: string;
+    hook_event_name?: string;
+}
+export interface GrepragHookConfig {
+    apiUrl: string;
+    apiKey: string;
+    enabled: boolean;
+}
+interface InboxMessage {
+    id: string;
+    from?: {
+        handle?: string;
+        tenant?: string;
+        project_id?: string | null;
+        session_id?: string | null;
+    };
+    to_session_id?: string | null;
+    body: string;
+    references?: unknown;
+    message_type?: string;
+    created_at?: string;
+}
+export declare function formatCodexInboxSteering(messages: InboxMessage[], session8: string): string | null;
+export declare function buildCodexInboxSteering(input: CodexSteeringInput, cfg: GrepragHookConfig, opts?: {
+    debounce?: boolean;
+}): Promise<string | null>;
+export {};

package/dist/codex-steering.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCodexInboxSteering = formatCodexInboxSteering;
+exports.buildCodexInboxSteering = buildCodexInboxSteering;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const project_anchor_1 = require("./project-anchor");
+const session_id_1 = require("./session-id");
+const CODEX_INBOX_DEBOUNCE_MS = 15_000;
+function stateDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return home ? path.join(home, '.greprag', 'codex') : null;
+}
+function inboxStatePath(sessionId) {
+    const dir = stateDir();
+    if (!dir)
+        return null;
+    const safe = sessionId.replace(/[^a-zA-Z0-9_.-]/g, '_').slice(0, 160);
+    return path.join(dir, `${safe}.inbox.json`);
+}
+function wasRecentlyPolled(sessionId, now = Date.now()) {
+    const file = inboxStatePath(sessionId);
+    if (!file)
+        return false;
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        const last = parsed.lastPollAt ? Date.parse(parsed.lastPollAt) : NaN;
+        return Number.isFinite(last) && now - last < CODEX_INBOX_DEBOUNCE_MS;
+    }
+    catch {
+        return false;
+    }
+}
+function stampPoll(sessionId) {
+    const file = inboxStatePath(sessionId);
+    if (!file)
+        return;
+    try {
+        const dir = path.dirname(file);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(file, JSON.stringify({ lastPollAt: new Date().toISOString() }, null, 2) + '\n');
+    }
+    catch {
+        // Steering is best-effort; cache failures should not disturb the turn.
+    }
+}
+function renderReferences(refs) {
+    if (!refs || typeof refs !== 'object')
+        return null;
+    try {
+        const json = JSON.stringify(refs);
+        if (!json || json === '{}')
+            return null;
+        return json.length > 500 ? json.slice(0, 500) + '...' : json;
+    }
+    catch {
+        return null;
+    }
+}
+function formatSender(message) {
+    const from = message.from || {};
+    const handle = from.handle || from.tenant || 'unknown sender';
+    const short = (0, session_id_1.truncateSessionId)(from.session_id || undefined);
+    return short ? `${handle}/${short}` : handle;
+}
+function formatReplyHint(message) {
+    const from = message.from || {};
+    const handle = from.handle || from.tenant;
+    const short = (0, session_id_1.truncateSessionId)(from.session_id || undefined);
+    if (handle && short)
+        return `Reply with: greprag send "..." --to ${handle}/${short}`;
+    if (handle)
+        return `Reply with: greprag send "..." --to ${handle}`;
+    return null;
+}
+function formatCodexInboxSteering(messages, session8) {
+    const unread = messages.filter(m => m && typeof m.body === 'string' && m.body.trim());
+    if (unread.length === 0)
+        return null;
+    const parts = [
+        `[GrepRAG inbox: ${unread.length} unread message(s) delivered to Codex session ${session8}]`,
+        `Treat these as live operator/agent messages. Act on them in this turn when relevant.`,
+    ];
+    unread.slice(0, 10).forEach((message, idx) => {
+        parts.push('');
+        parts.push(`Message ${idx + 1} (${message.id}):`);
+        parts.push(`From: ${formatSender(message)}`);
+        if (message.created_at)
+            parts.push(`At: ${message.created_at}`);
+        parts.push(message.body.trim());
+        const refs = renderReferences(message.references);
+        if (refs)
+            parts.push(`References: ${refs}`);
+        const reply = formatReplyHint(message);
+        if (reply)
+            parts.push(reply);
+    });
+    if (unread.length > 10) {
+        parts.push('');
+        parts.push(`Additional messages omitted: ${unread.length - 10}. Run greprag inbox --session ${session8} to inspect the rest.`);
+    }
+    return parts.join('\n');
+}
+async function buildCodexInboxSteering(input, cfg, opts = {}) {
+    if (!cfg.enabled || !cfg.apiKey)
+        return null;
+    const cwd = input.cwd || process.cwd();
+    const anchor = (0, project_anchor_1.readAnchor)(cwd);
+    if (!anchor.projectId)
+        return null;
+    const session8 = (0, session_id_1.truncateSessionId)(input.session_id);
+    if (!session8)
+        return null;
+    if (opts.debounce && wasRecentlyPolled(input.session_id || session8))
+        return null;
+    if (opts.debounce)
+        stampPoll(input.session_id || session8);
+    const url = new URL(`${cfg.apiUrl.replace(/\/+$/, '')}/v1/inbox`);
+    url.searchParams.set('project_id', anchor.projectId);
+    url.searchParams.set('session_id', session8);
+    try {
+        const res = await fetch(url, {
+            headers: { 'Authorization': `Bearer ${cfg.apiKey}` },
+        });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        return formatCodexInboxSteering(data.messages || [], session8);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=codex-steering.js.map

package/dist/codex-steering.js.map

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

package/dist/commands/codex.d.ts

@@ -0,0 +1,34 @@
+/** Codex live push sidecar.
+ *
+ * Codex lifecycle hooks only fire while Codex is active. This command supplies
+ * the missing live receiver: it subscribes to the GrepRAG inbox stream for a
+ * Codex session and wakes that session with `codex exec resume`.
+ */
+interface InboxMessage {
+    id: string;
+    body: string;
+    created_at: string;
+    to_session_id?: string | null;
+    from?: {
+        handle?: string | null;
+        tenant?: string | null;
+        email?: string | null;
+        project_id?: string | null;
+        session_id?: string | null;
+    };
+    references?: unknown;
+    message_type?: string;
+}
+export declare function currentCodexSessionId(): string | null;
+export declare function resolveCodexSessionId(input?: string): string | null;
+export declare function buildLivePushPrompt(msg: InboxMessage, session8: string): string;
+export declare function codexStartupInfo(): {
+    kind: string;
+    path: string;
+    installed: boolean;
+    hint: string;
+};
+export declare function installCodexStartup(): void;
+export declare function removeCodexStartup(): void;
+export declare function runCodex(args: string[]): Promise<void>;
+export {};