greprag
v5.85.6
Published
Private GrepRAG client for existing Claude Code, Codex, OpenCode, and Grok Build tenants.
Maintainers
Readme
GrepRAG
Private agent memory service for existing GrepRAG tenants. New accounts are closed; the npm client remains available so current users can install updates.
Quick Start
npm i -g grepragAn existing API key is required. Then either run /greprag inside a supported
agent, or run greprag init --api-key <existing-key> in a terminal.
Claude Code
Run /greprag in any Claude Code session, or:
greprag init --claudeCodex
Run /greprag in Codex after install, or:
greprag init --codex --api-key <existing-key>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.
Run greprag codex doctor to verify the hook file, current Codex thread, and
trust setup. Codex inbox rows surface through SessionStart/UserPromptSubmit
hooks; there is no startup watcher to install.
OpenCode
greprag init --opencodeThis 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:
greprag status --all-platformsWhat's active
- 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) orrecap/daily/weekly/hourly/turns/ships(by time window). (greprag memory briefingandgreprag 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 --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 --api-key <key> | Configure Codex hooks + skill |
| greprag codex doctor | Diagnose Codex hooks, session id, and trust path |
| 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) |
| greprag memory recap | Weekly + recent daily summaries (SessionStart shape; alias: briefing) |
| greprag memory daily --last N | Newest N daily summaries (also: weekly / hourly / turns / ships) |
| greprag inbox | List unread messages (auto-marks read) |
| greprag inbox --all | Full message history |
| greprag send "msg" --to <addr> | Send markdown message across tenants |
| greprag project-id | Print current project's UUID |
Requirements
- Node.js 18+
- Claude Code, Codex, or OpenCode
- An API key for an existing GrepRAG tenant.
How it works
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.
