@audiofool/moondog 0.2.0-beta.7 → 0.2.1

package/src/surfaces/cli/command-completions.mjs

@@ -19,6 +19,11 @@ const artChoices = choices([
   ["auto", N_("Choose artwork for this terminal")],
 ]);
 const motionChoices = choices([["on", N_("Animate the character artwork")], ["off", N_("Keep the artwork still")]]);
+const serviceChoices = choices([
+  ["spotify", N_("Whole songs on your Spotify devices")],
+  ["apple_music", N_("30-second previews, played here")],
+  ["netease", N_("Whole songs through ncm-cli")],
+]);
 const webChoices = choices([
   ["search", N_("Search public music sites")],
   ["read", N_("Read a public page")],
@@ -87,6 +92,7 @@ export function withCommandCompletions(commands, {
     theme: { argumentHint: "[paper|charcoal|terminal|auto]", choices: firstArgument(themeChoices) },
     art: { argumentHint: "[braille|ascii|off|auto]", choices: firstArgument(artChoices) },
     motion: { argumentHint: "[on|off]", choices: firstArgument(motionChoices) },
+    service: { argumentHint: "[spotify|apple_music|netease]", choices: firstArgument(serviceChoices) },
     lyrics: { argumentHint: "[sync]", choices: firstArgument(choices([["sync", N_("Check profile songs for lyrics")]])) },
     web: { argumentHint: "search <query> | read <url> | status", choices: firstArgument(webChoices) },
     spotify: {
@@ -94,6 +100,14 @@ export function withCommandCompletions(commands, {
       choices: (previous) => previous.length === 0 ? spotifyChoices
         : previous.length === 1 ? spotifyArguments.get(previous[0]) ?? [] : [],
     },
+    endpoint: {
+      argumentHint: "[add | remove <id>]",
+      choices: (previous) => previous.length === 0
+        ? choices([["add", N_("Add an endpoint by its address")], ["remove", N_("Remove an endpoint and its key")]])
+        : previous.length === 1 && previous[0] === "remove"
+          ? providers().filter((provider) => provider.id.startsWith("endpoint-")).map((provider) => ({ value: provider.id, label: provider.id, description: provider.name }))
+          : [],
+    },
     auth: {
       argumentHint: "[provider]",
       choices: (previous) => previous.length === 0 ? providers()

package/src/surfaces/cli/endpoint-command.mjs

@@ -0,0 +1,106 @@
+import { createInterface } from "node:readline/promises";
+
+import { ENDPOINT_FORMATS, readEndpoints } from "../../runtime/pi/custom-endpoints.mjs";
+import { createModelSettings } from "../../runtime/pi/model-settings.mjs";
+import { createReadlineOutput } from "./auth-command.mjs";
+import { sanitizeTerminalText } from "./format-output.mjs";
+
+// Endpoints from the terminal, as Settings › Model adds them in the window: any service that speaks
+// OpenAI's Chat Completions or Anthropic's Messages, by its address, an optional key and its model IDs.
+export function endpointHelpText() {
+  return `# Moondog endpoints
+
+- \`moondog endpoint\` - list the endpoints you added
+- \`moondog endpoint add\` - add one; Moondog asks for its name, address, format, key and model IDs
+- \`moondog endpoint remove <id>\` - remove one with its key
+
+The key is typed out of sight and kept in Moondog's private endpoints.json, never in a command.
+Leave the model IDs empty and Moondog asks the endpoint for its list.
+Then pick a model with /model <id>.`;
+}
+
+const line = (stream, value = "") => stream.write(`${sanitizeTerminalText(value)}\n`);
+const host = (address) => { try { return new URL(address).host; } catch { return address; } };
+
+export function describeEndpoints(endpoints) {
+  if (!endpoints.length) return "No endpoints yet. Add one with moondog endpoint add, or /endpoint add in Moondog.";
+  return endpoints.map((endpoint) => `${endpoint.id} - ${endpoint.name}, ${endpoint.format === "anthropic" ? "Anthropic" : "OpenAI"} format at ${host(endpoint.baseUrl)}, ` +
+    `${endpoint.models.length} model${endpoint.models.length === 1 ? "" : "s"}${endpoint.key ? ", key saved" : ""}`).join("\n");
+}
+
+// The questions an endpoint needs, one by one, on a paused terminal. The key is asked with the output
+// muted; an empty answer keeps the endpoint keyless, as a server on this Mac often is.
+async function askEndpoint({ input, output, signal }) {
+  const quiet = createReadlineOutput(output);
+  const readline = createInterface({ input, output: quiet.stream, terminal: Boolean(input.isTTY) });
+  const ask = (question) => readline.question(`${sanitizeTerminalText(question)} `, { signal });
+  try {
+    line(output);
+    line(output, "Add an endpoint. Press Ctrl+C to stop.");
+    const name = (await ask("Name (for example DeepSeek):")).trim();
+    const baseUrl = (await ask("Address (for example https://api.deepseek.com):")).trim();
+    const said = (await ask("Format, openai or anthropic [openai]:")).trim().toLowerCase();
+    const format = said.startsWith("a") ? "anthropic" : "openai";
+    if (said && !ENDPOINT_FORMATS.some((value) => value.startsWith(said[0]))) throw Object.assign(new Error("Answer openai or anthropic."), { code: "endpoint_format_invalid" });
+    line(output, "Key (hidden; leave empty for none):");
+    quiet.setMuted(true);
+    let key;
+    try { key = (await readline.question("", { signal })).trim(); } finally { quiet.setMuted(false); line(output); }
+    const models = (await ask("Model IDs, separated by commas (leave empty to ask the endpoint):")).trim();
+    return { name, baseUrl, format, key, models };
+  } finally {
+    readline.close();
+  }
+}
+
+export async function runEndpointCommand({
+  args = [],
+  json = false,
+  environment = process.env,
+  input = process.stdin,
+  output = process.stdout,
+  progressOutput = process.stderr,
+  signalTarget = process,
+  interactive = Boolean(input.isTTY && progressOutput.isTTY),
+  settings = createModelSettings({ environment }),
+} = {}) {
+  const [action = "list", ...rest] = args;
+  if (action === "help" || action === "--help" || action === "-h") {
+    line(output, endpointHelpText());
+    return null;
+  }
+  if (action === "list") {
+    if (rest.length) throw new Error("moondog endpoint list takes nothing after it.");
+    const endpoints = await readEndpoints(environment);
+    line(output, json ? JSON.stringify(endpoints.map(({ key, ...shown }) => ({ ...shown, keySaved: Boolean(key) })), null, 2) : describeEndpoints(endpoints));
+    return endpoints;
+  }
+  if (action === "remove") {
+    const wanted = rest.join(" ").trim().toLowerCase();
+    if (!wanted) throw new Error("Name the endpoint to remove: moondog endpoint remove <id>.");
+    const endpoint = (await readEndpoints(environment)).find((entry) => entry.id === wanted || entry.id === `endpoint-${wanted}` || entry.name.toLowerCase() === wanted);
+    if (!endpoint) throw new Error("No endpoint has that id or name. moondog endpoint lists them.");
+    await settings.removeEndpoint(endpoint.id);
+    line(output, `Removed ${endpoint.name} and its key.`);
+    return { id: endpoint.id, name: endpoint.name, removed: true };
+  }
+  if (action !== "add") throw new Error("Unknown endpoint command. Use add, remove, list, or help.");
+  if (rest.length) throw new Error("moondog endpoint add asks for everything it needs; type the key only at its hidden prompt.");
+  if (!interactive) throw new Error("Adding an endpoint asks for its key out of sight, so it needs an interactive terminal.");
+  const controller = new AbortController();
+  const stop = () => controller.abort();
+  signalTarget.once("SIGINT", stop);
+  try {
+    const answers = await askEndpoint({ input, output: progressOutput, signal: controller.signal });
+    if (answers.models === "") line(progressOutput, "Asking the endpoint for its models...");
+    const saved = await settings.saveEndpoint(answers);
+    line(output, `Saved ${saved.name} as ${saved.id}, with ${saved.models.length} model${saved.models.length === 1 ? "" : "s"}${saved.keySaved ? " and its key" : ""}.`);
+    line(output, `Next, pick one with /model ${saved.id}.`);
+    return saved;
+  } catch (error) {
+    if (controller.signal.aborted) throw Object.assign(new Error("Adding the endpoint was cancelled."), { code: "endpoint_cancelled" });
+    throw error;
+  } finally {
+    signalTarget.removeListener("SIGINT", stop);
+  }
+}

package/src/surfaces/cli/first-run-view.mjs

@@ -0,0 +1,138 @@
+import { getKeybindings, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+
+import { sanitizeTerminalText } from "./format-output.mjs";
+import { screenTranslator } from "../../i18n/index.mjs";
+
+// NetEase plays through its own command line tool and mpv, set up from a terminal as the window shows it.
+export const NETEASE_SETUP = "npm install -g @music163/ncm-cli && brew install mpv && ncm-cli login";
+
+/** The command that makes NetEase ready, from ncm-cli's state: missing installs it, signed out signs in. */
+export function neteaseSetupCommand(state) {
+  return state === "signed_out" ? "ncm-cli login" : NETEASE_SETUP;
+}
+
+export function playbackServiceName(service, tr) {
+  return service === "netease" ? tr("NetEase Music") : service === "apple_music" ? "Apple Music" : "Spotify";
+}
+
+/**
+ * The music services the first run and /service offer, as the window does: Spotify and Apple Music,
+ * and NetEase once ncm-cli is installed, signed in or not. Choosing NetEase before it is signed in
+ * shows how to set it up.
+ */
+export function playbackServiceChoices(tr, { netease = "unavailable", current = null } = {}) {
+  const neteaseOffered = ["ready", "signed_out", "missing"].includes(netease) || current === "netease";
+  return [
+    { value: "spotify", label: "Spotify", description: tr("Whole songs on your Spotify devices") },
+    { value: "apple_music", label: "Apple Music", description: tr("30-second previews, played here") },
+    ...(neteaseOffered ? [{
+      value: "netease", label: tr("NetEase Music"),
+      description: netease === "ready" ? tr("Whole songs through ncm-cli") : tr("Set up ncm-cli first"),
+    }] : []),
+  ];
+}
+
+function clean(value) {
+  return sanitizeTerminalText(String(value ?? "")).replace(/\s+/gu, " ").trim();
+}
+
+function paint(value, width, theme) {
+  const clipped = truncateToWidth(value, width, "");
+  const line = clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
+  return theme.plain ? line.replace(/\u001b\[[\d;:]*m/g, "") : theme.background(theme.text(line));
+}
+
+/**
+ * The one-time first run: where music plays, then the model. It draws the step it is given and
+ * reports the listener's choice; the room saves it and runs Pi's own model picker and sign-in.
+ */
+export class FirstRunView {
+  constructor({ getTheme, getRows, onAction, getText = () => screenTranslator("en") }) {
+    this.getTheme = getTheme;
+    this.getRows = getRows;
+    this.getText = getText;
+    this.onAction = onAction;
+    this.state = { step: "service", steps: 2, services: [], model: {} };
+    this.selected = 0;
+    this.focused = false;
+  }
+
+  invalidate() {}
+
+  setState(state) {
+    if (state.step !== this.state.step) this.selected = 0;
+    this.state = { ...this.state, ...state };
+  }
+
+  actions() {
+    const tr = this.getText();
+    if (this.state.step === "service") return this.state.services.map((choice) => ({ type: "service", ...choice }));
+    const { provider, signIn } = this.state.model ?? {};
+    return signIn ? [
+      { type: "auth", label: tr("Sign in to {provider}", { provider }), description: provider === "openai" ? tr("ChatGPT sign-in or API key") : tr("API key") },
+      { type: "model", label: tr("Choose another model") },
+    ] : [{ type: "model", label: tr("Choose a model"), description: tr("Pick a provider and model, then sign in") }];
+  }
+
+  handleInput(data) {
+    const keys = getKeybindings();
+    const actions = this.actions();
+    if (keys.matches(data, "tui.select.cancel")) {
+      this.onAction?.({ type: "skip" });
+    } else if (keys.matches(data, "tui.select.up") || keys.matches(data, "tui.select.down")) {
+      if (actions.length) this.selected = (this.selected + (keys.matches(data, "tui.select.up") ? -1 : 1) + actions.length) % actions.length;
+    } else if (keys.matches(data, "tui.select.confirm") && actions.length) {
+      const { type, value } = actions[Math.min(this.selected, actions.length - 1)];
+      this.onAction?.({ type, value });
+    }
+  }
+
+  render(width) {
+    const columns = Math.max(1, Math.floor(width));
+    const rows = Number(this.getRows());
+    const height = Number.isFinite(rows) ? Math.max(0, Math.floor(rows)) : 0;
+    if (!height) return [];
+    const theme = this.getTheme();
+    const tr = this.getText();
+    const inset = columns >= 8 ? 1 : 0;
+    const inner = Math.max(1, columns - inset * 2);
+    const wrap = (text, ink) => wrapTextWithAnsi(clean(text), inner).map(ink);
+    const { step, steps, note, setup, model = {} } = this.state;
+    const intro = steps > 1 ? tr("Two things before we start: where I play your music, and the model I talk through.")
+      : step === "service" ? tr("One thing before we start: where I play your music.") : tr("One thing before we start: the model I talk through.");
+    const question = step === "service" ? tr("Where should I play music?") : tr("Which model should I talk through?");
+    const help = step === "service" ? tr("/service changes it any time.")
+      : model.signIn ? tr("{model} is saved, but you're not signed in to {provider} yet.", { model: `${model.provider}/${model.model}`, provider: model.provider })
+        : tr("Sign in with ChatGPT, or use an API key from another provider. Your profile works without one.");
+    const notice = [
+      ...(note?.text ? wrap(note.text, note.tone === "error" ? theme.error : theme.accent) : []),
+      ...(setup ? [...wrap(tr("NetEase plays through its own command line tool. Run this in another terminal, then choose it again:"), theme.muted),
+        ...wrap(setup, theme.text)] : []),
+    ];
+    const actions = this.actions();
+    this.selected = Math.min(this.selected, Math.max(0, actions.length - 1));
+    const labelWidth = Math.max(0, ...actions.map(({ label }) => visibleWidth(clean(label)))) + 4;
+    const items = actions.map(({ label, description }, index) => {
+      const selected = index === this.selected;
+      const name = (selected ? "◉ " : "  ") + clean(label);
+      const room = inner - labelWidth;
+      const line = description && room >= 12
+        ? name + " ".repeat(Math.max(1, labelWidth - visibleWidth(name))) + theme.muted(truncateToWidth(clean(description), room, "…"))
+        : name;
+      return selected ? theme.selected(truncateToWidth(name, inner, "")) + line.slice(name.length) : theme.text(line);
+    });
+    // The choices always show. On a short screen the blank rows go first, then the introduction,
+    // then the line under the question; what happened last stays longest.
+    const title = theme.bold(tr("Welcome to the machine."));
+    const parts = (gaps, introduced, helped) => [
+      title, ...(introduced ? wrap(intro, theme.muted) : []), ...(gaps ? [""] : []),
+      ...(notice.length ? [...notice, ...(gaps ? [""] : [])] : []),
+      theme.bold(question), ...(helped ? wrap(help, theme.muted) : []), ...(gaps ? [""] : []),
+    ];
+    const space = height - items.length;
+    const above = [parts(true, true, true), parts(false, true, true), parts(false, false, true), parts(false, false, false)]
+      .find((candidate) => candidate.length <= space) ?? (space > 0 ? parts(false, false, false).slice(-space) : []);
+    const lines = [...above, ...items];
+    return Array.from({ length: height }, (_, row) => paint(" ".repeat(inset) + (lines[row] ?? ""), columns, theme));
+  }
+}

package/src/surfaces/cli/format-output.mjs

@@ -557,5 +557,5 @@ export function formatLocalResult(command, value, tr = screenTranslator("en")) {
 }
 
 export function helpText(tr = screenTranslator("en")) {
-  return tr("# Every command\n\nFrom your shell:\n\n- `moondog --version` - show the installed version\n- `moondog update [--check] [--channel latest|beta]` - check for or install a published release\n- `moondog web status|search|read [arguments] [--json]` - look things up on public music sites through DeepSeek, Brave Search or the Codex CLI\n- `moondog demo-history --output <absolute-file.zip> [--json]` - make a fictional Spotify history ZIP to try the importer with\n- `moondog auth login <provider>` - sign in to a model provider; the key is typed out of sight, and openai-codex uses your ChatGPT sign-in\n- `moondog auth status [provider]` - see which sign-ins are saved\n- `moondog auth logout <provider>` - sign out of a provider\n- `moondog spotify help` - set up and control Spotify\n- `moondog spotify login [client-id]` - connect Spotify in your browser\n- `moondog spotify now|devices|queue` - see what Spotify is playing, where, and what's next\n- `moondog spotify recent` - see what you played lately\n- `moondog spotify sync-recent` - add your latest plays to your profile\n- `moondog spotify sync-library` - add your Spotify library to your profile\n- `moondog spotify play|pause|next|previous` - control Spotify playback\n- `moondog listenbrainz import-history <listen-history.json>` - add a ListenBrainz listens file to your profile\n- `moondog catalog latest-single --artist <name> [--known-release <title> | --from <spotify-history.zip>]` - find an artist's latest single on Apple Music (US), no model needed\n- `moondog status [--json]` - see where things stand\n- `moondog taste [--json]` - your listening report\n- `moondog taste --html [--output <file.html>]` - save your report as a web page that works offline\n- `moondog taste --card [--output <file.html>]` - save a short recap you can check before sharing\n- `moondog taste --from <spotify-history.zip> --html` - a one-off report from a Spotify ZIP, without saving it\n- `moondog taste --from <account-data.zip> --from <extended-history.zip> --html` - a one-off report from both Spotify exports together\n- `moondog taste --from <spotify-history.zip> --save --html` - save the Spotify history, then show your full report\n- `moondog data inspect --scope <listening|apple|profile>` - see what's stored, and get the code needed to reset it\n- `moondog data export --scope <listening|apple|profile> --output <directory>` - export a copy, leaving the original alone\n- `moondog data reset --scope <listening|apple|profile> --confirm <token>` - set stored data aside (it is archived, not deleted)\n- `moondog profile build [--force]` - build or resume a saved profile with your connected model\n- `moondog profile saved [offset]` - read your saved profile\n- `moondog profile explain <number>` - trace a saved finding to its evidence\n- `moondog profile corrections [--all]` - everything you've told me, including earlier choices\n- `moondog profile correct --artist <name> (--like|--avoid)` - like an artist, or keep them out\n- `moondog profile correct --track <title> --by <artist> (--like|--avoid)` - like a track, or keep it out\n- `moondog profile retract <correction-id>` - undo one of your choices\n- `moondog demo --offline [--json]` - a demo with made-up data, no sign-in needed\n- `moondog demo [prompt] [--json]` - the same demo, talking through your model\n- `moondog ask <prompt>` - ask one question and exit\n- `moondog remember <text>` - ask me to remember something\n- `moondog forget <memory-id>` - forget something\n- `moondog memory reflect [--dry-run] [--json]` - let me think over recent conversations now\n- `moondog` - open the listening room\n\nInside the listening room:\n\n- `/update [--check] [--channel latest|beta]` - check for updates, or save and close this session to install one\n- `/status` or `/sources` - see where things stand\n- `/profile` or `/taste` - your profile, and why each song or artist is there\n- `/taste report` - the whole report on one page\n- `/profile build [--force]` - build or resume a saved reading; Ctrl+C keeps progress\n- `/profile saved [offset]` - read your saved profile\n- `/profile explain <number>` - inspect a saved finding's evidence\n- `/profile corrections [--all]` - everything you've told me\n- `/profile correct --track \"<title>\" --by \"<artist>\" (--like|--avoid)` - like a track, or keep it out\n- `/profile correct --artist \"<name>\" (--like|--avoid)` - like an artist, or keep them out\n- `/profile retract <correction-id>` - undo a choice\n- `/memory` - what I remember\n- `/tools` - what I can do right now\n- `/doctor` - check your setup\n- `/model` - pick the model I talk through\n- `/model <provider> <model>` - switch straight to a model\n- `/model refresh [provider]` - update public model choices; keep the selected model\n- `/auth [provider]` - sign in to a model provider\n- `/web status|search|read` - look things up on public music sites\n- `/import [path]` - bring in your history, library, or a playlist\n- `/language` - choose the language Moondog uses\n- `/spotify` - Spotify commands\n- `/spotify login [client-id]` - connect Spotify\n- `/spotify now|devices|queue` - see what's playing, where, and what's next\n- `/spotify recent|sync-recent` - see or save your latest plays\n- `/spotify import-history \"/path/to/spotify-history.zip\"` - add a Spotify ZIP, no sign-in needed\n- `/skip` or `/stop` - move to the next song preview, or stop them\n- `/reload` - reload model settings and sign-ins\n- `/remember [kind] <text>` - ask me to remember something\n- `/forget <memory-id>` - forget something\n- `/rewind` or Alt+R - edit an earlier message in place; the messages after it are replaced\n- `/branch` - go on from here in a new conversation; this one stays saved\n- `/rewind latest` - edit the most recent message\n- `/resume` - pick up a saved conversation\n- `/resume <session-id>` - go straight to one\n- `/new` - start fresh; the last one stays saved\n- `/quit` - exit\n\nAnything you type that isn't a command goes to the model you picked with `/model`, or the one set in `MOONDOG_PROVIDER` and `MOONDOG_MODEL`.\nSign in with `/auth`, or set the provider's API key in your environment. `/auth openai-codex` uses your ChatGPT sign-in.\nOnce your profile is ready, I can search your library, explain what I see, and plan playlists with you.\nI can only control Spotify after `moondog spotify login`, and I never post, send messages, delete anything, or spend money.\nAsk me to move playback onto a device by name, such as your iPhone.");
+  return tr("# Every command\n\nFrom your shell:\n\n- `moondog --version` - show the installed version\n- `moondog update [--check] [--channel latest|beta]` - check for or install a published release\n- `moondog web status|search|read [arguments] [--json]` - look things up on public music sites through DeepSeek, Brave Search or the Codex CLI\n- `moondog demo-history --output <absolute-file.zip> [--json]` - make a fictional Spotify history ZIP to try the importer with\n- `moondog auth login <provider>` - sign in to a model provider; the key is typed out of sight; `openai --chatgpt` signs in with your ChatGPT subscription\n- `moondog auth status [provider]` - see which sign-ins are saved\n- `moondog auth logout <provider>` - sign out of a provider\n- `moondog spotify help` - set up and control Spotify\n- `moondog spotify login [client-id]` - connect Spotify in your browser\n- `moondog spotify now|devices|queue` - see what Spotify is playing, where, and what's next\n- `moondog spotify recent` - see what you played lately\n- `moondog spotify sync-recent` - add your latest plays to your profile\n- `moondog spotify sync-library` - add your Spotify library to your profile\n- `moondog spotify play|pause|next|previous` - control Spotify playback\n- `moondog listenbrainz import-history <listen-history.json>` - add a ListenBrainz listens file to your profile\n- `moondog catalog latest-single --artist <name> [--known-release <title> | --from <spotify-history.zip>]` - find an artist's latest single on Apple Music (US), no model needed\n- `moondog status [--json]` - see where things stand\n- `moondog taste [--json]` - your listening report\n- `moondog taste --html [--output <file.html>]` - save your report as a web page that works offline\n- `moondog taste --card [--output <file.html>]` - save a short recap you can check before sharing\n- `moondog taste --from <spotify-history.zip> --html` - a one-off report from a Spotify ZIP, without saving it\n- `moondog taste --from <account-data.zip> --from <extended-history.zip> --html` - a one-off report from both Spotify exports together\n- `moondog taste --from <spotify-history.zip> --save --html` - save the Spotify history, then show your full report\n- `moondog data inspect --scope <listening|apple|profile>` - see what's stored, and get the code needed to reset it\n- `moondog data export --scope <listening|apple|profile> --output <directory>` - export a copy, leaving the original alone\n- `moondog data reset --scope <listening|apple|profile> --confirm <token>` - set stored data aside (it is archived, not deleted)\n- `moondog profile build [--force]` - build or resume a saved profile with your connected model\n- `moondog profile saved [offset]` - read your saved profile\n- `moondog profile explain <number>` - trace a saved finding to its evidence\n- `moondog profile corrections [--all]` - everything you've told me, including earlier choices\n- `moondog profile correct --artist <name> (--like|--avoid)` - like an artist, or keep them out\n- `moondog profile correct --track <title> --by <artist> (--like|--avoid)` - like a track, or keep it out\n- `moondog profile retract <correction-id>` - undo one of your choices\n- `moondog demo --offline [--json]` - a demo with made-up data, no sign-in needed\n- `moondog demo [prompt] [--json]` - the same demo, talking through your model\n- `moondog ask <prompt>` - ask one question and exit\n- `moondog remember <text>` - ask me to remember something\n- `moondog forget <memory-id>` - forget something\n- `moondog memory reflect [--dry-run] [--json]` - let me think over recent conversations now\n- `moondog` - open the listening room\n\nInside the listening room:\n\n- `/update [--check] [--channel latest|beta]` - check for updates, or save and close this session to install one\n- `/status` or `/sources` - see where things stand\n- `/profile` or `/taste` - your profile, and why each song or artist is there\n- `/taste report` - the whole report on one page\n- `/profile build [--force]` - build or resume a saved reading; Ctrl+C keeps progress\n- `/profile saved [offset]` - read your saved profile\n- `/profile explain <number>` - inspect a saved finding's evidence\n- `/profile corrections [--all]` - everything you've told me\n- `/profile correct --track \"<title>\" --by \"<artist>\" (--like|--avoid)` - like a track, or keep it out\n- `/profile correct --artist \"<name>\" (--like|--avoid)` - like an artist, or keep them out\n- `/profile retract <correction-id>` - undo a choice\n- `/memory` - what I remember\n- `/tools` - what I can do right now\n- `/doctor` - check your setup\n- `/model` - pick the model I talk through\n- `/model <provider> <model>` - switch straight to a model\n- `/model refresh [provider]` - update public model choices; keep the selected model\n- `/auth [provider]` - sign in to a model provider\n- `/web status|search|read` - look things up on public music sites\n- `/import [path]` - bring in your history, library, or a playlist\n- `/language` - choose the language Moondog uses\n- `/service [spotify|apple_music|netease]` - choose where I play music\n- `/spotify` - Spotify commands\n- `/spotify login [client-id]` - connect Spotify\n- `/spotify now|devices|queue` - see what's playing, where, and what's next\n- `/spotify recent|sync-recent` - see or save your latest plays\n- `/spotify import-history \"/path/to/spotify-history.zip\"` - add a Spotify ZIP, no sign-in needed\n- `/skip` or `/stop` - move to the next song preview, or stop them\n- `/reload` - reload model settings and sign-ins\n- `/remember [kind] <text>` - ask me to remember something\n- `/forget <memory-id>` - forget something\n- `/rewind` or Alt+R - edit an earlier message in place; the messages after it are replaced\n- `/branch` - go on from here in a new conversation; this one stays saved\n- `/rewind latest` - edit the most recent message\n- `/resume` - pick up a saved conversation\n- `/resume <session-id>` - go straight to one\n- `/new` - start fresh; the last one stays saved\n- `/quit` - exit\n\nAnything you type that isn't a command goes to the model you picked with `/model`, or the one set in `MOONDOG_PROVIDER` and `MOONDOG_MODEL`.\nSign in with `/auth`, or set the provider's API key in your environment. `/auth openai` signs in with your ChatGPT subscription or an API key.\nOnce your profile is ready, I can search your library, explain what I see, and plan playlists with you.\nI can only control Spotify after `moondog spotify login`, and I never post, send messages, delete anything, or spend money.\nAsk me to move playback onto a device by name, such as your iPhone.");
 }