@mundy/agrep 0.1.6 → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agrep contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,26 +1,33 @@
 # agrep
 
-grep your AI coding agents' chat history - Claude Code, Codex, opencode, Antigravity,
-Kimi CLI, Cline - straight from the shell. One searchable cross-agent history, a context-window command
-(`agrep around`) built for agents and humans, native session resume, and a local web
-explorer (`agrep ui`).
+Find, open, resume and watch your AI agents' work - Claude Code, Codex,
+opencode, Antigravity, Kimi CLI, Cline, Gemini CLI, crush, Cursor, pi, and
+oh-my-pi - straight from the shell. One local index of every conversation,
+tool call and result, with native resume and a live board across tools.
 
 This npm package is a thin shim: agrep is a python package with a bundled rust binary,
 and the shim runs it through [uv](https://docs.astral.sh/uv/) (or pipx). uv manages
 python itself, so this works even on a machine with no python installed.
 
 ```
-npm i -g @mundy/agrep
-# or: npm i -g agrep-cli
+uvx agrep "race condition"   # zero-install try (uv runs the real PyPI package)
+# or on npm: npm i -g @mundy/agrep   (npx @mundy/agrep "race condition")
 agrep "race condition"     # first run indexes your agent stores, then greps
 ```
 
-Global npm installs also try to preinstall the matching PyPI tool with
-`uv tool install` when uv is available. npm's own `bin` shim is still the PATH
-entrypoint, so `agrep` works even if uv's tool directory is not on PATH.
+Global npm installs run one-time setup from postinstall
+(`agrep setup --yes --no-semantic --no-archive`): the index is built and the
+detected agents are taught immediately; every written block is disclosed in
+the setup output and undone by `agrep remove`. That includes the
+uninstall-cleanup sentinel (a launchd agent, systemd user units, or a
+scheduled task) whose only job is stripping agrep's own blocks and hooks if
+the package disappears. Set `AGREP_NO_AUTO_SETUP=1` to only warm uv's cache
+instead, or `AGREP_SKIP_POSTINSTALL=1` to skip postinstall entirely. npm's
+own `bin` shim remains the PATH entrypoint, so the install does not create
+or replace a persistent uv-managed command.
 
 The npm shim pins the matching PyPI version under the hood, so npm and PyPI releases
-do not drift. Prefer the direct route? `uv tool install agrep==0.1.5` - same thing,
-no node in the middle.
+do not drift. Prefer the direct route? `uv tool install agrep` installs the same
+agrep package without the Node shim.
 
 Full docs: https://github.com/dannyisbad/agrep

package/bin.js

@@ -4,7 +4,7 @@
 // box with no python at all. pipx is the fallback. If neither exists we print the
 // one-liner that fixes it instead of half-installing anything ourselves.
 //
-// AGREP_PYPI_SPEC overrides what gets run (e.g. a local wheel path, or agrep==0.1.0).
+// AGREP_PYPI_SPEC overrides what gets run (e.g. a local wheel path, or agrep==X.Y.Z).
 
 "use strict";
 const { spawnSync } = require("child_process");

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@mundy/agrep",
-  "version": "0.1.6",
-  "description": "grep your AI coding agents' chat history (Claude Code, Codex, opencode, Antigravity, Kimi, Cline) - npm shim that runs the real package via uv/pipx",
+  "version": "0.4.0",
+  "description": "Find, open, resume and watch your AI agents' work (Claude Code, Codex, opencode, Antigravity, Kimi, Cline, Gemini, crush, Cursor, pi, oh-my-pi) - npm shim that runs the real package via uv/pipx",
   "bin": { "agrep": "bin.js" },
   "scripts": {
     "postinstall": "node postinstall.js"
   },
-  "files": ["bin.js", "postinstall.js", "README.md"],
+  "files": ["bin.js", "postinstall.js", "README.md", "LICENSE"],
   "engines": { "node": ">=16" },
-  "keywords": ["claude", "codex", "opencode", "kimi", "cline", "agent", "chat", "history", "grep", "cli"],
+  "keywords": ["claude", "codex", "opencode", "antigravity", "kimi", "cline", "gemini", "crush", "cursor", "pi", "oh-my-pi", "agent", "chat", "history", "grep", "cli"],
   "repository": { "type": "git", "url": "git+https://github.com/dannyisbad/agrep.git" },
   "homepage": "https://github.com/dannyisbad/agrep#readme",
   "author": "mundy (https://mundy.sh)",

package/postinstall.js

@@ -1,7 +1,15 @@
 #!/usr/bin/env node
-// Warm the matching PyPI tool when installed globally through npm. npm's own
-// `bin` shim is still the portable PATH entrypoint; this just makes the Python
-// side ready too when uv is available.
+// Global installs finish enrolled, not merely downloaded: after warming uv's
+// ephemeral tool cache, run the pinned `agrep setup --yes` so the box is
+// indexed and the detected agents are taught the moment `npm install -g`
+// returns. Everything setup writes is disclosed in its output, owned by
+// agrep, and undone by `agrep remove`; --no-semantic defers the ~52MiB model
+// fetch to the first semantic use, and --no-archive leaves source-store
+// retention off until someone asks for it (`agrep setup --archive`).
+//
+// AGREP_NO_AUTO_SETUP=1 restores the old warm-only behavior;
+// AGREP_SKIP_POSTINSTALL=1 skips this script entirely. The npm shim remains
+// the entrypoint and resolves the pinned PyPI package on every run.
 
 "use strict";
 
@@ -11,6 +19,9 @@ const { version } = require("./package.json");
 const spec = process.env.AGREP_PYPI_SPEC || `agrep==${version}`;
 const npmGlobal = String(process.env.npm_config_global || "").toLowerCase() === "true";
 const forced = Boolean(process.env.AGREP_POSTINSTALL_FORCE);
+const strict = Boolean(process.env.AGREP_POSTINSTALL_STRICT);
+const autoSetup = !process.env.AGREP_NO_AUTO_SETUP;
+const SETUP_TIMEOUT_MS = 15 * 60 * 1000;
 
 if (process.env.AGREP_SKIP_POSTINSTALL) {
   process.exit(0);
@@ -25,28 +36,45 @@ function has(cmd) {
   return probe.status === 0;
 }
 
-function tryRun(cmd, args) {
-  const result = spawnSync(cmd, args, { stdio: "inherit", shell: false });
+function tryRun(cmd, args, options) {
+  const result = spawnSync(cmd, args, { shell: false, ...options });
   return !result.error && result.status === 0;
 }
 
-if (has("uv")) {
-  console.log(`agrep: installing matching PyPI tool with uv (${spec})`);
-  const ok = tryRun("uv", [
-    "tool",
-    "install",
-    "--force",
-    "--exclude-newer-package",
-    "agrep=false",
-    spec,
-  ]);
-  if (!ok) {
-    console.warn("agrep: uv tool install failed; npm's agrep shim will still run via uv at command time.");
-  }
-  process.exit(0);
+function agrepArgs(...rest) {
+  return [
+    "tool", "run",
+    "--exclude-newer-package", "agrep=false",
+    "--from", spec,
+    "agrep", ...rest,
+  ];
 }
 
-console.warn(
-  "agrep: uv was not found, so the PyPI tool was not preinstalled. " +
-  "npm's agrep shim is still installed; install uv for first-run execution."
-);
+let done = false;
+const uvAvailable = has("uv");
+if (uvAvailable && autoSetup) {
+  // Inherited stdio: npm surfaces this with --foreground-scripts (and on
+  // failure), so every file setup touches is disclosed, never silent.
+  console.log(
+    "agrep: running one-time setup (agrep setup --yes) - writes agent instruction blocks"
+    + " and an uninstall-cleanup sentinel, all undone by `agrep remove`;"
+    + " AGREP_NO_AUTO_SETUP=1 skips this.");
+  done = tryRun(
+    "uv", agrepArgs("setup", "--yes", "--no-semantic", "--no-archive"),
+    { stdio: "inherit", timeout: SETUP_TIMEOUT_MS });
+  if (!done) {
+    console.warn("agrep: automatic setup did not finish; `agrep setup` completes it any time.");
+  }
+} else if (uvAvailable) {
+  // Warm-only: keep npm output clean; the shim provisions on first run.
+  done = tryRun("uv", agrepArgs("--version"), { stdio: "ignore" });
+  if (!done) {
+    console.warn("agrep: uv cache warm failed; the first agrep run will retry");
+  }
+} else {
+  console.warn("agrep: install uv (https://docs.astral.sh/uv) - agrep needs it on first run.");
+}
+if (!done && strict) {
+  console.error("agrep: postinstall failed to provision the pinned PyPI tool");
+  process.exit(1);
+}