Skip to content

armgit / xerj

Public Imported from GitHub
0

AI search engine and MCP server for bots and agents. One Rust binary indexes code, docs, logs, JSONL/CSV and PDFs for BM25 full-text, vector and hybrid search, code search without grep, agent memory and RAG. Elasticsearch-compatible API; Corpus Hub serves hundreds of reference memory corpora.

docs: replace dead xerj admin magic-link with the boot hint (#1615)

xerj-org6fe6894cfd40
diff --git a/demo/DEMO_RUNBOOK.md b/demo/DEMO_RUNBOOK.md
index 8e46397c6..5017a91a3 100644
--- a/demo/DEMO_RUNBOOK.md
+++ b/demo/DEMO_RUNBOOK.md
@@ -406,7 +406,7 @@ The HTML version of the same flow lives at `landing/demo/index.html` §3.5 ("Cla
http://localhost:9200/_xerj-console/setup#token=…
├──────────────────────────────────────────────────────────────────────────────┤
│ │
-│ Need a fresh link? `xerj admin magic-link --role owner` │
+│ Need a fresh link? Restart this node: a new one is printed on boot. │
└──────────────────────────────────────────────────────────────────────────────┘
```
diff --git a/engine/docs/xerj-console-backend/API_DESIGN_v1.md b/engine/docs/xerj-console-backend/API_DESIGN_v1.md
index 2f9453fc6..98ee00504 100644
--- a/engine/docs/xerj-console-backend/API_DESIGN_v1.md
+++ b/engine/docs/xerj-console-backend/API_DESIGN_v1.md
@@ -158,7 +158,7 @@ When `xerj` starts and detects `.xerj_users` is empty (no `active` users exist),
4. The magic-link doc is marked `used_at` so the same token cannot be reused.
5. From this point forward bootstrap mode is off; the next restart skips the printout.
-If the user closes the browser before finishing enrollment, the link is still valid until expiry — they can re-open it. If it expires, an admin can mint a fresh one with `xerj admin magic-link --role admin` (CLI calls `POST /_xerj-console/api/v1/auth/magic/issue` against the local socket using the binary's own root credential, see §3.7).
+If the user closes the browser before finishing enrollment, the link is still valid until expiry — they can re-open it. If it expires before anyone enrolls, restart the node: while no active user exists, every boot re-mints and reprints a fresh link. The banner says `Need a fresh link? Restart this node: a new one is printed on boot.` The binary has no `admin` subcommand, so there is no CLI that calls `POST /_xerj-console/api/v1/auth/magic/issue` for this.
### 3.3 Login flow (returning user)
diff --git a/landing/demo/index.html b/landing/demo/index.html
index 3bac1c932..62cfa57ba 100644
--- a/landing/demo/index.html
+++ b/landing/demo/index.html
@@ -470,7 +470,7 @@ footer .links { display: flex; gap: 28px; flex-wrap: wrap; }
http://localhost:9200/_xerj-console/setup#token=T8AC0tmun3Ca-DNrepOawL42uOZaDSTkXBoFI6TIPZg
├──────────────────────────────────────────────────────────────────────────────┤
│ │
-│ Need a fresh link? `xerj admin magic-link --role owner` │
+│ Need a fresh link? Restart this node: a new one is printed on boot. │
└──────────────────────────────────────────────────────────────────────────────┘
<span class="prompt">$ </span># From a second shell — first /_cluster/health 200 in <span class="num">47 ms</span> (median of 5 cold-boots, 5ms poll)
<span class="prompt">$ </span>curl -s localhost:9200/_cluster/health | jq .status
@@ -688,7 +688,7 @@ node demo/scripts/full-demo-flow.js
http://localhost:9200/_xerj-console/setup#token=T8AC0tmun3Ca-DNrepOawL42uOZaDSTkXBoFI6TIPZg
├──────────────────────────────────────────────────────────────────────────────┤
│ │
-│ Need a fresh link? `xerj admin magic-link --role owner` │
+│ Need a fresh link? Restart this node: a new one is printed on boot. │
└──────────────────────────────────────────────────────────────────────────────┘
↑ captured live 2026-04-27 19:11:41Z · single-use · token never lands on disk (only sha256 in .xerj_magic_links)</code></pre>