@mrplex/embedder 0.1.0 → 0.1.2

package/README.md

@@ -1,7 +1,7 @@
 # @mrplex/embedder
 
 A ready-to-use local embedding provider for [mrplex](https://github.com/usergenic/mrplex)'s
-`--embed-cmd` hook. It runs `bge-small-en-v1.5` (384-dim) on CPU via ONNX — no GPU, no
+`--embedder` hook. It runs `bge-small-en-v1.5` (384-dim) on CPU via ONNX — no GPU, no
 separate service. mrplex spawns it once and keeps it resident, so the model loads a single
 time and each batch is one JSON line in / one JSON line out.
 
@@ -30,34 +30,34 @@ cd packages/embedder && npm install
 
 ## Use with mrplex
 
-After a global install, point mrplex at the `mrplex-embedder` binary:
+After a global install:
 
 ```bash
 # Serve with the hook — every write auto-embeds.
-mrplex serve --unsafe --embed-cmd "mrplex-embedder --stdio"
+mrplex serve --unsafe --embedder mrplex-embedder
 
 # One-off backfill of an existing repo.
-mrplex embed backfill -r notes --embed-cmd "mrplex-embedder --stdio"
+mrplex embed backfill -r notes --embedder mrplex-embedder
 
-# Or make it ambient.
-export MRPLEX_EMBED_CMD="mrplex-embedder --stdio"
+# Or make it ambient for every mrplex command:
+export MRPLEX_EMBEDDER=mrplex-embedder
+# mrplex config set-embedder mrplex-embedder   # same thing, persisted
 ```
 
 **Monorepo / local checkout** (no global install):
 
 ```bash
-mrplex serve --unsafe \
-  --embed-cmd "node packages/embedder/embedder.mjs --stdio"
+mrplex serve --unsafe --embedder "node packages/embedder/embedder.mjs"
 ```
 
 ### Different models
 
 ```bash
 # Stronger, slower (768-dim).
-export MRPLEX_EMBED_CMD="mrplex-embedder --stdio --model fast-bge-base-en-v1.5"
+export MRPLEX_EMBEDDER="mrplex-embedder --model fast-bge-base-en-v1.5"
 
 # Matryoshka truncation (re-embed after changing --dim).
-export MRPLEX_EMBED_CMD="mrplex-embedder --stdio --dim 256"
+export MRPLEX_EMBEDDER="mrplex-embedder --dim 256"
 ```
 
 List supported model keys:
@@ -68,13 +68,14 @@ mrplex-embedder --list-models
 
 ## Flags
 
-- `--stdio` — required transport (one JSON line per batch over stdin/stdout).
 - `--model KEY` — any `fastembed` model key. Default `fast-bge-small-en-v1.5`.
   Others include `fast-all-MiniLM-L6-v2`, `fast-bge-base-en-v1.5`,
   `fast-multilingual-e5-large`. Run `--list-models` for the full set.
 - `--dim N` — truncate + re-normalize each vector to `N` dims (for Matryoshka
   models). The truncation is encoded into the reported model string
   (`<key>@<N>`) so mrplex treats a dim change as a model change and re-embeds.
+- `--stdio` — optional no-op; stdio is the default transport (one JSON line
+  per batch over stdin/stdout).
 - `--list-models` — print supported `--model` keys and exit.
 - `--help`, `--version` — usage and version.
 

package/embedder.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Local embedding provider for mrplex's `--embed-cmd` hook.
+ * Local embedding provider for mrplex's `--embedder` hook.
  *
  * Speaks the subprocess contract (design §5.3): one JSON line in on stdin
  * `{ chunks: string[] }`, one JSON line out on stdout
@@ -8,8 +8,8 @@
  * ONCE and reuses it for every batch (src/embed/cmd-hook.ts), so the model
  * loads a single time and stays resident — no per-call cold start.
  *
- *   mrplex serve --unsafe --embed-cmd "mrplex-embedder --stdio"
- *   mrplex embed backfill -r notes --embed-cmd "mrplex-embedder --stdio"
+ *   mrplex serve --unsafe --embedder mrplex-embedder
+ *   mrplex embed backfill -r notes --embedder mrplex-embedder
  *
  * Model: bge-small-en-v1.5 (384-dim) by default — strong retrieval quality for
  * its size, and small vectors keep mrplex's brute-force cosine scan fast. Runs
@@ -35,13 +35,13 @@ const has = (name) => argv.includes(name);
 
 function printHelp() {
   console.error(`mrplex-embedder ${VERSION}
-Local CPU embedding provider for mrplex's --embed-cmd hook.
+Local CPU embedding provider for mrplex's --embedder hook.
 
 Usage:
-  mrplex-embedder --stdio [--model KEY] [--dim N]
+  mrplex-embedder [--model KEY] [--dim N]
 
 Options:
-  --stdio          required transport (one JSON line per batch over stdin/stdout)
+  --stdio          optional; stdio is the default (one JSON line per batch over stdin/stdout)
   --model KEY      fastembed model key (default: fast-bge-small-en-v1.5)
   --dim N          truncate + re-normalize to N dims (Matryoshka models only)
   --list-models    print supported --model keys and exit
@@ -89,11 +89,6 @@ if (has("--list-models")) {
   process.exit(0);
 }
 
-if (!has("--stdio")) {
-  printHelp();
-  process.exit(2);
-}
-
 // fastembed keys its models by an enum whose values are the string keys above.
 const model = Object.values(EmbeddingModel).find((v) => v === modelKey);
 if (!model) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mrplex/embedder",
-  "version": "0.1.0",
-  "description": "Local CPU embedding provider for mrplex's --embed-cmd hook (bge-small-en-v1.5 via fastembed). Isolated from mrplex core so fastembed/tar stay out of the core dependency graph.",
+  "version": "0.1.2",
+  "description": "Local CPU embedding provider for mrplex's --embedder hook (bge-small-en-v1.5 via fastembed). Isolated from mrplex core so fastembed/tar stay out of the core dependency graph.",
   "type": "module",
   "license": "MIT",
   "author": "Brendan Baldwin <brendan@usergenic.com>",
@@ -33,7 +33,7 @@
     "README.md"
   ],
   "scripts": {
-    "start": "node embedder.mjs --stdio",
+    "start": "node embedder.mjs",
     "test": "node --test test/*.test.mjs"
   },
   "engines": {