@aicopycoders/exodus 2026.7.200-beta.4 → 2026.7.200-beta.6

package/assets/skills/exodus/SKILL.md

@@ -18,6 +18,7 @@ This skill ROUTES. Read what the user wants, name the destination skill, and han
 | Static image ads ("make images", "statics", "render this ad") | `exodus-image` (the image front door — it menus engines and confirms before firing) |
 | A specific image engine they already chose | `exodus-creative` (native / copy-derived / ref-match) or `exodus-template` (33 ad-type formats) |
 | Meme ads ("exodus, meme this offer", "make me meme ads") | `exodus-meme` |
+| Run / chain / build / edit a saved workflow ("run my workflow", "what does this workflow need", "build a workflow that…", "list my workflows") | `exodus-workflow` |
 | Onboard a new brand / build the primer | `exodus-primer` (with winning ads) or `exodus-foundation` (no ads yet) |
 | List/switch/troubleshoot brands | `exodus-brand` |
 | See past runs / find an output | `exodus-browse` |

package/assets/skills/exodus-workflow/SKILL.md

@@ -0,0 +1,173 @@
+---
+name: exodus-workflow
+description: Run, chain, build, and edit saved Exodus Workflows — the multi-node automations that wire Genesis bots, primers, briefs, and image nodes together on the dashboard canvas — from the CLI. Use it to list a brand's workflows, describe what a workflow needs before running it (inputs, per-workspace primer prerequisites, outputs), run one and collect its outputs, chain one workflow's output into another's input, browse the bot catalog, and author or update a workflow contract via export → edit → import. Only invoke when the user has explicitly invoked Exodus: they said "exodus" in the request ("exodus, run my launch workflow", "exodus, what does this workflow need", "exodus, build a workflow that turns a swipe into hooks then ads", "list my exodus workflows", "exodus, edit that workflow"), named this skill or /exodus-workflow, ran an `npx @aicopycoders/exodus workflow` command, or the `exodus` hub skill routed here. Never claim generic "workflow"/"automation" requests ("automate this", "build me a workflow") without Exodus context — in shared folders those may belong to the user's other tools; if the user did not say exodus, this skill is not for them. The bare word "Genesis" without "exodus" refers to the member's own Genesis API key and personal bot recipes, NOT to Exodus.
+---
+
+```operator-guide
+Subcommands:
+  exodus workflow list [--json]                              List the brand's saved workflows
+  exodus workflow describe <workflowId|name> [--json]        Inputs, prerequisites, outputs
+  exodus workflow bots [--category <cat>] [--slug <slug>] [--json]   Bot catalog / one bot's spec
+  exodus workflow run <workflowId|name> [--input key=value ...] [--wait] [--json]   Run it
+  exodus workflow status [--id <runId>] [--json]             Poll a run / read its outputs
+  exodus workflow export <workflowId|name> [--out <file>]    Dump the contract JSON
+  exodus workflow import <file> [--update <workflowId>] [--dry-run] [--json]   Author/edit
+
+Key flags:
+  --input key=value    Repeatable run input; the value may contain "="
+  --input key=@path    Load the value from a file (path resolved from the cwd);
+                       use key=@@text to keep a leading "@" as a literal character
+  --wait               Poll until the run reaches a terminal status, then print outputs
+  --id <runId>         Run id for `status` detail
+  --category <cat>     (bots) Filter the catalog to one category id
+  --slug <slug>        (bots) Show a single bot's full port + param spec
+  --out <file>         (export) Write JSON to a file instead of stdout
+  --update <workflowId> (import) Update this workflow in place (optimistic-concurrency
+                       guarded by the export's updatedAt — a 409 means re-export first)
+  --dry-run            (import) Validate + resolve refs without writing; returns issues
+
+Auth: Bearer (EXODUS_API_KEY). The canvas lives on the dashboard at /workflows.
+```
+
+# Workflow — Run, Chain, and Build Saved Automations
+
+An Exodus **Workflow** is a saved graph the member builds on the dashboard canvas (`/workflows`): brief and primer sources feed Genesis bots, bots feed other bots or an image node, and an Output node collects the deliverables. This skill is the CLI operator for those graphs — discover and run them, chain one into the next, and author or edit the contract without opening a browser.
+
+Three jobs, three sections below. Read the request and jump to the one that fits; don't walk all three when the user just wants a run.
+
+## 1. Discover & run
+
+The mistake to avoid is firing a run blind and wasting it on a missing input or an unmet prerequisite. Always **`describe` before `run`**.
+
+### Step 1 — List
+
+```bash
+npx @aicopycoders/exodus workflow list
+```
+
+Prints the brand's saved workflows (name, id, node/edge counts, timestamps). If the user named the workflow already, skip straight to `describe`.
+
+### Step 2 — Describe (read inputs, prereqs, outputs)
+
+```bash
+npx @aicopycoders/exodus workflow describe "Launch Flow"
+```
+
+Accepts a workflow id **or** a name. It reports three things:
+
+- **Inputs** — each free input the run needs: field name, source (`text`, `swipe-ad`, `swipe-bundle`, `organic-url`, `ad-url`), whether it's required, and a description. These are the `--input key=value` pairs you'll pass.
+- **Prerequisites** — the per-workspace primer markers the graph's primer nodes depend on, each shown **✓ stored** or **✗ missing** for *this brand*. **If any prerequisite is ✗, warn the user before running** — the run will not produce good output (or will fail) without it. Route them to the `exodus-primer` / `exodus-foundation` skill to fill the gap first, rather than burning a run.
+- **Outputs** — the deliverables the Output node collects (text or image, with labels), so you know what to expect back.
+
+### Step 3 — Gather inputs
+
+Fill every required input. For a free-text brief you can compose a **bespoke brief from in-session research** — the winning angle you just worked out, the swipe you analyzed — and pass it inline (`--input brief="..."`) or, if it's long, write it to a project file and pass it with `@file` (see Chain, below). For URL/swipe sources, pass the value the source expects.
+
+### Step 4 — Run and collect
+
+```bash
+npx @aicopycoders/exodus workflow run "Launch Flow" --input brief="new cortisol offer, problem-aware" --wait
+```
+
+`--wait` polls to a terminal status and prints the run's collected outputs — text inline, image URLs. Without `--wait` the command returns the `runId` and you poll it yourself:
+
+```bash
+npx @aicopycoders/exodus workflow status --id <runId>
+```
+
+Report the outputs plus a short take. Don't call a run "done" off the kickoff line alone — a run reaches `completed`, `partial`, or `failed`; a `partial` means some nodes were skipped or failed, so read the status before declaring victory.
+
+## 2. Chain — feed one workflow's output into the next
+
+The chaining surface is the run's flattened outputs. After a `--wait` run (or once `status` shows terminal), pull the machine-readable outputs:
+
+```bash
+npx @aicopycoders/exodus workflow status --id <runId> --json
+```
+
+The response carries a top-level `outputs` array — each entry is `{ nodeId, botSlug?, type, label, text?, imageUrl?, imageId? }`. Extract the text you want (e.g. `.outputs[].text`) and pass it into the next workflow's input:
+
+```bash
+# Inline, for short outputs
+npx @aicopycoders/exodus workflow run "Ad Writer" --input hooks="<text from run A>" --wait
+```
+
+**The file-as-persistence convention.** For anything reusable or long — a brief, a sales letter, a hook pool — write the text to a **markdown file in the project** and pass it with `@file`. This is the deliberate v1 alternative to a server-side store: the file *is* the persistence layer, versioned in the project alongside the brand's other artifacts.
+
+```bash
+# Save run A's text output to a project file, then feed it to workflow B
+npx @aicopycoders/exodus workflow status --id <runId> --json   # copy .outputs[].text into state/hooks.md
+npx @aicopycoders/exodus workflow run "Ad Writer" --input hooks=@state/hooks.md --wait
+```
+
+`@path` is resolved from the current directory. If the literal value you need actually starts with `@`, escape it as `@@` (e.g. `--input handle=@@brand` passes the string `@brand`).
+
+Use this pattern to compose pipelines the canvas doesn't wire directly: run the research/hook workflow, persist its best output as a file, then run the writing workflow off that file — reproducibly, because the file stays.
+
+## 3. Build & edit — author a workflow contract
+
+The documented way to learn the contract format is to **export an existing workflow and study it** — there is no separate schema doc. The loop is: learn the bots → learn the format → compose → dry-run until clean → import → review on the canvas.
+
+### Step 1 — Learn the bot catalog
+
+```bash
+npx @aicopycoders/exodus workflow bots                     # full catalog, grouped by category
+npx @aicopycoders/exodus workflow bots --category writing  # one category
+npx @aicopycoders/exodus workflow bots --slug new-hook-bot # one bot's full port + param spec
+npx @aicopycoders/exodus workflow bots --json              # raw catalog for machine use
+```
+
+Per bot you get its **input ports** (id, what it accepts — `text` / `primer` / `image`, whether it's required, and for primer ports which `primerKinds` gate it — `body` / `hook` / `headline` / `summary`), its **params** (select/text/toggle/number/multiselect, with options and defaults), and its output type. This is what tells you which node can wire into which — a port only accepts an edge whose source produces a type it lists in `accepts`.
+
+### Step 2 — Learn the format by exporting
+
+```bash
+npx @aicopycoders/exodus workflow export "Launch Flow" --out launch.json
+```
+
+Study `launch.json`: it's the `exodus-workflow` contract — `nodes` (each with `id`, `kind` = `brief`/`bot`/`primer`/`image`/`output`, a `config`, and an optional `position`) and `edges` (`source`/`sourceHandle` → `target`/`targetHandle`, the handles being port ids). An export also carries `workflowId` + `updatedAt` at the top — those are update anchors, not part of the graph.
+
+### Step 3 — Compose the contract
+
+Author the JSON by hand or by adapting an export. **Node positions are optional** — leave them out and the server auto-layouts the graph on import; you don't need to compute coordinates.
+
+### Step 4 — Dry-run like a compiler loop
+
+```bash
+npx @aicopycoders/exodus workflow import launch.json --dry-run
+```
+
+`--dry-run` validates and resolves refs without writing. It returns compiler-style issues — each names the **node id**, the **port id** where relevant, and a concrete **remedy** (the exact edit that fixes it). Codes you'll see include `dangling-edge`, `unknown-port`, `type-mismatch`, `missing-required-input`, `duplicate-input`, `cycle`, `unknown-kind`, and `bad-config`. Fix, re-run `--dry-run`, repeat until it's clean — same loop as fixing type errors.
+
+### Step 5 — Import (create or update)
+
+```bash
+# Create a new workflow
+npx @aicopycoders/exodus workflow import launch.json
+
+# Update an existing workflow in place
+npx @aicopycoders/exodus workflow import launch.json --update wf_123
+```
+
+Then **tell the user to review it on the canvas at `/workflows`** — the CLI writes the graph; the human eye confirms it reads right.
+
+**Two rules for edits (`--update`):**
+
+- **Always export a backup first.** v1 has no version history — a destructive `--update` overwrites the live workflow with no undo. `export --out backup.json` before you import over it.
+- **A 409 means the canvas moved.** `--update` sends the export's `updatedAt` as an optimistic-concurrency guard. If someone edited the workflow on the dashboard since your export, the import 409s. Re-export the current workflow, reapply your edits onto the fresh contract, and import again — never force past a 409, or you'll clobber their change.
+
+## Failure handling
+
+- **`describe` shows a ✗ prerequisite** — don't run yet. Fill the primer via `exodus-primer` / `exodus-foundation`, then re-check `describe`.
+- **Run comes back `partial` or `failed`** — read `status --id <runId>` (drop `--json` for a readable view) to see which node failed and why before re-running.
+- **`import --dry-run` issues** — fix the exact node/port each issue names using its remedy; don't guess.
+- **`import --update` 409** — re-export, reapply, re-import (see Step 5). This is a conflict, not a bug.
+- **Auth / whoami failure** — run `npx @aicopycoders/exodus doctor` and confirm `EXODUS_API_KEY`.
+- **Wrong brand** — workflows are per-brand. `npx @aicopycoders/exodus brand current` to confirm you're on the brand you think you are; switch with the `exodus-brand` skill.
+
+## Not the right skill for
+
+- **Running a single Genesis writing pass** (brief → copy in two voices) — that's `exodus-genesis`. Reach here when the member has a *saved multi-node workflow* to run or build.
+- **One-off image renders** — `exodus-image` / `exodus-creative` / `exodus-template`.
+- **Building the primer a workflow depends on** — `exodus-primer` (winning ads) or `exodus-foundation` (no ads).
+- **Finding a past run's output doc** — `exodus-browse`.

package/dist/bin/exodus.js

@@ -18,6 +18,7 @@ const OTHER_COMMANDS = new Set([
     "init",
     "migrate",
     "segment",
+    "workflow",
 ]);
 const HIDDEN_COMMANDS = new Set([
     "creative",

package/dist/commands/brand.js

@@ -5,6 +5,7 @@ import { sniffImageType, BRAND_IMAGE_MAX_BYTES } from "../lib/image-sniff.js";
 import { getActiveBrand, setActiveBrand, clearActiveBrand, findWorkspaceRoot, } from "../lib/state.js";
 import { detectLayout, ensureBrandDir, resolveActiveBrand, brandStateDir, brandDirFor, } from "../lib/layout.js";
 import { promptYesNo } from "../lib/prompts.js";
+import { pkgRef } from "../lib/channel.js";
 const AUTO_END_MARKER = "<!-- exodus:auto-section-end — manual brand notes below survive `brand use` refreshes -->";
 export const helpText = `
 exodus brand — list, switch, and inspect brands available to your CLI
@@ -180,7 +181,7 @@ async function runCreate(name) {
         console.log(`✓ Wrote ${refresh.pathRel}.`);
     }
     console.log(`\nNext: set up the brand's primer to unlock the pipelines —\n` +
-        `  say "exodus, set up my brand primer" (or run \`npx @aicopycoders/exodus primer\`).`);
+        `  say "exodus, set up my brand primer" (or run \`npx ${pkgRef()} primer\`).`);
 }
 async function runDelete(slug, flags) {
     if (!slug)

package/dist/commands/doctor.js

@@ -7,6 +7,7 @@ import { findWorkspaceRoot } from "../lib/state.js";
 import { detectLayout, listBrandDirs, resolveActiveBrand, brandStateDir, } from "../lib/layout.js";
 import { auth401Hint, isPlaceholderApiUrl } from "../lib/backend-hint.js";
 import { compareVersions, readPackageVersion, } from "../lib/release.js";
+import { channelOf, pkgRef, stampChannel } from "../lib/channel.js";
 export const helpText = `
 exodus doctor — Preflight checks for your local Claude Code setup
 
@@ -58,7 +59,7 @@ export function checkEnvFile() {
         return {
             ok: false,
             label: ".env",
-            fix: "run `npx @aicopycoders/exodus init`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)",
+            fix: `run \`npx ${pkgRef()} init\`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)`,
         };
     }
     const content = fs.readFileSync(envPath, "utf8");
@@ -80,7 +81,7 @@ export function checkEnvFile() {
         ok: false,
         label: ".env",
         detail: "missing EXODUS_API_URL or EXODUS_API_KEY",
-        fix: "run `npx @aicopycoders/exodus init`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)",
+        fix: `run \`npx ${pkgRef()} init\`, then paste your dashboard .env block (Settings → Claude Code → Copy .env block)`,
     };
 }
 export async function checkWhoami() {
@@ -124,7 +125,7 @@ export async function checkWhoami() {
                 todo: true,
                 label: "Brand primer",
                 detail: `${d.workspaceSlug} has no primer yet — set one up to unlock the pipelines`,
-                fix: `say "exodus, set up my brand primer" (or run \`npx @aicopycoders/exodus foundation\` from a source doc, or paste it at /settings?tab=brands&brand=${d.workspaceSlug})`,
+                fix: `say "exodus, set up my brand primer" (or run \`npx ${pkgRef()} foundation\` from a source doc, or paste it at /settings?tab=brands&brand=${d.workspaceSlug})`,
             };
         }
         return {
@@ -182,7 +183,7 @@ export async function checkActiveBrandMatch() {
         ok: false,
         label: "Active brand",
         detail: `local active brand "${resolved.slug}" (${source}) is NOT in your accessible list — the server ignores it and every command silently targets the key's default brand. available: ${available}`,
-        fix: `run \`npx @aicopycoders/exodus brand use <slug>\` with one of your brands, or \`npx @aicopycoders/exodus brand clear\` to fall back to the key default`,
+        fix: `run \`npx ${pkgRef()} brand use <slug>\` with one of your brands, or \`npx ${pkgRef()} brand clear\` to fall back to the key default`,
     };
 }
 const FRESHNESS_SUBTREES = ["commands", "lib", "bin"];
@@ -251,7 +252,9 @@ export function checkExodusDistFreshness(pkgRootOverride) {
     }
     return { ok: true, label: "Exodus CLI build", detail: "dist up-to-date" };
 }
-const NPM_REGISTRY = "https://registry.npmjs.org/@aicopycoders/exodus/latest";
+function npmRegistryUrl(channel) {
+    return `https://registry.npmjs.org/@aicopycoders/exodus/${channel}`;
+}
 export async function checkVersionCurrency(pkgRootOverride, fetchImpl = fetch) {
     let pkgRoot;
     if (pkgRootOverride) {
@@ -265,28 +268,29 @@ export async function checkVersionCurrency(pkgRootOverride, fetchImpl = fetch) {
         }
     }
     const local = readPackageVersion(pkgRoot);
+    const channel = channelOf(local);
     try {
         const ctrl = new AbortController();
         const t = setTimeout(() => ctrl.abort(), 8_000);
         let res;
         try {
-            res = await fetchImpl(NPM_REGISTRY, { signal: ctrl.signal });
+            res = await fetchImpl(npmRegistryUrl(channel), { signal: ctrl.signal });
         }
         finally {
             clearTimeout(t);
         }
         if (!res.ok)
             throw new Error(`HTTP ${res.status}`);
-        const latest = (await res.json()).version;
-        if (compareVersions(local, latest) >= 0) {
+        const published = (await res.json()).version;
+        if (compareVersions(local, published) >= 0) {
             return { ok: true, label: "Exodus version", detail: `${local} — up to date` };
         }
         return {
             ok: true,
             warn: true,
             label: "Exodus version",
-            detail: `${local} installed, ${latest} available`,
-            fix: "run `npx @aicopycoders/exodus@latest init` to update (or `npm update -g @aicopycoders/exodus`)",
+            detail: `${local} installed, ${published} available`,
+            fix: `run \`npx ${pkgRef(channel)} init\` to update (or \`npm install -g ${pkgRef(channel)}\`)`,
         };
     }
     catch (err) {
@@ -326,7 +330,7 @@ export async function checkApiAndDrive() {
                 ok: false,
                 label: "Dashboard API key",
                 detail: `HTTP ${res.status}`,
-                fix: "regenerate at Settings → API Keys, then paste the new .env block (or re-run `npx @aicopycoders/exodus init`)",
+                fix: `regenerate at Settings → API Keys, then paste the new .env block (or re-run \`npx ${pkgRef()} init\`)`,
             },
             {
                 ok: false,
@@ -445,7 +449,9 @@ export async function checkDashboardAuth() {
             ok: false,
             label: "Dashboard auth (dashboard-routed pipelines)",
             detail: res.data?.error ?? "401 from /api/doctor/dashboard-ping",
-            fix: hint ?? "run `npx @aicopycoders/exodus@latest init` to update the CLI — older releases skipped the Bearer header on dashboard routes",
+            fix: hint
+                ? stampChannel(hint)
+                : `run \`npx ${pkgRef()} init\` to update the CLI — older releases skipped the Bearer header on dashboard routes`,
         };
     }
     return {
@@ -476,7 +482,7 @@ export function checkLayout() {
         return {
             ok: true,
             label: "Layout",
-            detail: "single-brand (legacy) — run `npx @aicopycoders/exodus migrate` to switch to the multi-brand layout",
+            detail: `single-brand (legacy) — run \`npx ${pkgRef()} migrate\` to switch to the multi-brand layout`,
         };
     }
     const brands = listBrandDirs(root);
@@ -490,7 +496,7 @@ export function checkLayout() {
             warn: true,
             label: "Layout",
             detail: `multi-brand — no brand folders yet; ${active}`,
-            fix: "run `npx @aicopycoders/exodus@latest init` (or `npx @aicopycoders/exodus brand use <slug>`) to create your brand folders",
+            fix: `run \`npx ${pkgRef()} init\` (or \`npx ${pkgRef()} brand use <slug>\`) to create your brand folders`,
         };
     }
     const missingProfiles = brands.filter((b) => !fs.existsSync(path.join(b.dir, "state", "brand-profile.md")));
@@ -500,7 +506,7 @@ export function checkLayout() {
             warn: true,
             label: "Layout",
             detail: `multi-brand, ${brands.length} brand folder(s); ${active}; missing brand profile in: ${missingProfiles.map((b) => b.slug).join(", ")}`,
-            fix: "run `npx @aicopycoders/exodus@latest init` to refresh every brand folder's profile",
+            fix: `run \`npx ${pkgRef()} init\` to refresh every brand folder's profile`,
         };
     }
     return {
@@ -518,7 +524,7 @@ export function checkBrandProfileGenesisDepth() {
             ok: false,
             label: "brand-profile",
             detail: `${rel} is missing`,
-            fix: "run `npx @aicopycoders/exodus brand use <slug>` to generate it",
+            fix: `run \`npx ${pkgRef()} brand use <slug>\` to generate it`,
         };
     }
     const contents = fs.readFileSync(filePath, "utf-8");

package/dist/commands/init.js

@@ -3,12 +3,13 @@ import path from "node:path";
 import { writeEnvScaffold, ensureGitignore, writeSkills, writeReferences, writeDocs, ensureBaseDirs, } from "../lib/scaffold.js";
 import { loadWorkspaceEnv } from "../lib/load-env.js";
 import { ensureBrandDir } from "../lib/layout.js";
+import { pkgRef } from "../lib/channel.js";
 export const helpText = `
 exodus init — Set up (or refresh) an Exodus workspace in the current folder
 
 Usage:
-  npx @aicopycoders/exodus init        Scaffold the workspace + install skills
-  npx @aicopycoders/exodus init --root <dir>   Target a specific folder
+  npx ${pkgRef()} init        Scaffold the workspace + install skills
+  npx ${pkgRef()} init --root <dir>   Target a specific folder
 
 Run this in a fresh, empty folder. It creates the workspace layout, writes the
 Exodus + Genesis skills into .claude/skills/, scaffolds a comment-only .env, and

package/dist/commands/meme.js

@@ -1,5 +1,6 @@
 import { apiPostDashboard, getDashboardUrl } from "../lib/client.js";
 import { formatError } from "../lib/format.js";
+import { pkgRef } from "../lib/channel.js";
 import { readFileSync } from "node:fs";
 export const helpText = `
 exodus meme — Meme generator: brief → recommended formats → one batched run
@@ -26,7 +27,7 @@ Flow:
 
 Keys (strict BYOK — checked server-side before anything starts):
   classic (layer 1) memes need your Imgflip login; AI (layer 2/3) memes need
-  your Kie.ai key; captions always need your LLM key. Run \`npx @aicopycoders/exodus doctor\`.
+  your Kie.ai key; captions always need your LLM key. Run \`npx ${pkgRef()} doctor\`.
 
 Examples:
   exodus meme recommend --brief "grounding sheets reduce inflammation"
@@ -114,7 +115,7 @@ async function runRecommend(flags) {
     if (!res.ok) {
         console.error(formatError(res));
         if (res.status === 400) {
-            console.error("Hint: run `npx @aicopycoders/exodus doctor` to check your keys.");
+            console.error(`Hint: run \`npx ${pkgRef()} doctor\` to check your keys.`);
         }
         process.exit(1);
         return;
@@ -171,7 +172,7 @@ async function runRun(flags) {
     if (!res.ok) {
         console.error(formatError(res));
         if (res.status === 400) {
-            console.error("Hint: run `npx @aicopycoders/exodus doctor` to check your keys.");
+            console.error(`Hint: run \`npx ${pkgRef()} doctor\` to check your keys.`);
         }
         process.exit(1);
         return;
@@ -233,7 +234,7 @@ async function runRegenerate(flags) {
     if (!res.ok) {
         console.error(formatError(res));
         if (res.status === 400) {
-            console.error("Hint: run `npx @aicopycoders/exodus doctor` to check your keys.");
+            console.error(`Hint: run \`npx ${pkgRef()} doctor\` to check your keys.`);
         }
         process.exit(1);
         return;

package/dist/commands/migrate.js

@@ -4,6 +4,7 @@ import { execSync } from "node:child_process";
 import { apiGet, apiGetDashboard } from "../lib/client.js";
 import { getActiveBrand, setLayoutVersion, findWorkspaceRoot } from "../lib/state.js";
 import { detectLayout, brandDirFor, ensureBrandDir, BRAND_MARKER_FILE, } from "../lib/layout.js";
+import { pkgRef } from "../lib/channel.js";
 export const helpText = `
 exodus migrate — convert a single-brand install to the multi-brand layout
 
@@ -15,7 +16,7 @@ What it does (one-time, opt-in — updates never force this):
      falling back to the key's bound brand).
   2. Creates a subfolder for it and MOVES your brand-specific files in:
      state/  and  output/  →  <brand>/state/  and  <brand>/output/
-  3. Marks the install as multi-brand. From then on, \`npx @aicopycoders/exodus@latest init\`
+  3. Marks the install as multi-brand. From then on, \`npx ${pkgRef()} init\`
      creates a subfolder for every brand you own, and running a command
      from inside a brand's folder targets that brand automatically.
 
@@ -94,7 +95,7 @@ async function resolveBrand() {
     }
     if (!slug) {
         fail("could not determine which brand this install belongs to.\n" +
-            "  Run `npx @aicopycoders/exodus brand use <slug>` first (or check your network/.env), then re-run `npx @aicopycoders/exodus migrate`.");
+            `  Run \`npx ${pkgRef()} brand use <slug>\` first (or check your network/.env), then re-run \`npx ${pkgRef()} migrate\`.`);
     }
     if (!name) {
         try {
@@ -115,7 +116,7 @@ export async function run(flags) {
     const root = findWorkspaceRoot();
     if (detectLayout(root) === "v2") {
         console.log("✓ Already on the multi-brand layout — nothing to migrate.");
-        console.log("  Run `npx @aicopycoders/exodus@latest init` to sync brand folders.");
+        console.log(`  Run \`npx ${pkgRef()} init\` to sync brand folders.`);
         return;
     }
     const brand = await resolveBrand();
@@ -128,7 +129,7 @@ export async function run(flags) {
     if (conflicts.length > 0) {
         fail(`"${brandDirRel}/" already contains different versions of:\n` +
             conflicts.map((f) => `    ${f}`).join("\n") +
-            "\n  Reconcile or remove them, then re-run `npx @aicopycoders/exodus migrate`. Nothing was changed.");
+            `\n  Reconcile or remove them, then re-run \`npx ${pkgRef()} migrate\`. Nothing was changed.`);
     }
     console.log(`Migrating this install to the multi-brand layout...`);
     console.log(`  brand: ${brand.slug} (${brand.name})`);
@@ -151,8 +152,8 @@ export async function run(flags) {
   Shared files (.env, exodus/, .claude/skills/, references/) did not move.
 
 Next steps:
-  • Run \`npx @aicopycoders/exodus@latest init\` to pull folders for your other brands.
+  • Run \`npx ${pkgRef()} init\` to pull folders for your other brands.
   • Run commands from inside ${brandDirRel}/ to target it automatically,
-    or keep using \`npx @aicopycoders/exodus brand use <slug>\` from anywhere.
+    or keep using \`npx ${pkgRef()} brand use <slug>\` from anywhere.
 `.trimEnd());
 }