diff --git a/USING_GBRAIN_WITH_GSTACK.md b/USING_GBRAIN_WITH_GSTACK.md
index f0dfb14c..17dea2b0 100644
--- a/USING_GBRAIN_WITH_GSTACK.md
+++ b/USING_GBRAIN_WITH_GSTACK.md
@@ -159,6 +159,7 @@ The skill re-collects a PAT (one-time, discarded after), lists every project in
 | `gstack-gbrain-supabase-verify` | Structural URL check. Rejects direct-connection URLs (`db.*.supabase.co:5432`) with exit 3 |
 | `gstack-gbrain-supabase-provision` | Management API wrapper. Subcommands: `list-orgs`, `create`, `wait`, `pooler-url`, `list-orphans`, `delete-project`. All require `SUPABASE_ACCESS_TOKEN` in env. `create` and `pooler-url` also require `DB_PASS`. `--json` mode available on every subcommand. |
 | `gstack-gbrain-repo-policy` | Per-remote trust triad. Subcommands: `get`, `set`, `list`, `normalize` |
+| `gstack-gbrain-source-wireup` | Registers your `~/.gstack/` brain repo with gbrain as a federated source via `gbrain sources add` + `git worktree`, then runs an initial `gbrain sync`. Idempotent. Replaces the dead `consumers.json + /ingest-repo` HTTP wireup from v1.12.x. Flags: `--strict`, `--source-id <id>`, `--no-pull`, `--uninstall`, `--probe`. |
 
 ### gbrain CLI (upstream tool)
 
diff --git a/docs/gbrain-sync.md b/docs/gbrain-sync.md
index 02e9dd4c..e5f1d700 100644
--- a/docs/gbrain-sync.md
+++ b/docs/gbrain-sync.md
@@ -43,9 +43,13 @@ The command:
 3. Pushes an initial commit with just the config.
 4. Writes `~/.gstack-brain-remote.txt` (URL-only, no secrets —
    safe to copy to another machine).
-5. Registers GBrain as a reader if `GBRAIN_URL` + `GBRAIN_TOKEN` are
-   configured. Otherwise you can add readers later with
-   `gstack-brain-reader add <name> --ingest-url <url> --token <token>`.
+5. Wires the gstack-brain repo into your local gbrain as a federated
+   source (via `gbrain sources add` + `git worktree`) so `gbrain search`
+   can index your synced learnings, plans, and designs. Implementation
+   lives in `bin/gstack-gbrain-source-wireup`. The old
+   `gstack-brain-reader add --ingest-url ...` HTTP path was removed in
+   v1.15.1.0 — it depended on a `/ingest-repo` endpoint gbrain never
+   shipped.
 
 After init, the **next skill you run** will ask you ONE question about
 privacy mode: