fullsendai 0.2.1 → 0.3.1

package/README.md

@@ -39,10 +39,22 @@ added, renamed or given new abilities or prices, `status` and `doctor` notice an
 `npx fullsendai sync` does it. A tool whose model was renamed follows it to its new ID; one whose model was removed
 moves to the recommended model, and says so.
 
+## Open FullsendAI
+
+```sh
+fullsendai
+```
+
+In a terminal, `fullsendai` on its own opens FullsendAI: your connected tools with their model and spend this month,
+your balance, and a prompt that takes every command below without the `fullsendai` in front. Tab completes commands,
+model IDs and tools; ↑ and ↓ go through what you typed; Ctrl+C cancels a step; `exit` or Ctrl+D leaves. The first
+time, it connects your tools first, then offers to install the `fullsendai` command so it's one word from then on
+(or run `npm install -g fullsendai` yourself). `npx fullsendai` works too, without installing anything.
+
 ## Commands
 
 ```sh
-npx fullsendai connect              # find tools, sign in, connect (the default)
+npx fullsendai connect              # find tools, sign in, connect (the default in scripts)
 npx fullsendai status               # each tool's model and spend this month, and calls a backup provider answered
 npx fullsendai model                # switch every connected tool to another model (or name it: model sulfuras)
 npx fullsendai doctor --fix         # check settings, keys and a real request; repair settings

package/dist/cli.mjs

@@ -7323,10 +7323,12 @@ var require_dist = __commonJS({
 });
 
 // src/main.ts
+import { spawn as spawn2 } from "node:child_process";
 import { createHash as createHash2 } from "node:crypto";
+import { createInterface } from "node:readline";
 
 // src/api.ts
-var VERSION = true ? "0.2.1" : "0.0.0-dev";
+var VERSION = true ? "0.3.1" : "0.0.0-dev";
 var agent = `fullsendai-cli/${VERSION} (${process.platform}; node ${process.versions.node})`;
 var Api = class {
   constructor(origin, timeoutMs = 6e4) {
@@ -7540,6 +7542,10 @@ function onPath(command, w) {
     }
   return void 0;
 }
+function fullsendaiInstalled(w) {
+  const found2 = onPath("fullsendai", w);
+  return !!found2 && !/[\\/]_npx[\\/]/.test(found2);
+}
 function editorExtensions(w) {
   return [".vscode", ".vscode-insiders", ".vscode-oss", ".cursor", ".windsurf"].map((dir) => join2(w.home, dir, "extensions"));
 }
@@ -7550,6 +7556,87 @@ function cursorInstalled(w) {
   return existsSync2(join2(w.home, ".cursor"));
 }
 
+// src/shell.ts
+var SHELL_COMMANDS = [
+  { name: "status", usage: "status", about: "Each tool\u2019s model and spend this month, and your balance" },
+  { name: "model", usage: "model [id]", about: "Switch every tool to another model" },
+  { name: "sync", usage: "sync", about: "Update every tool with the current models, abilities and prices" },
+  { name: "doctor", usage: "doctor [--fix]", about: "Check every tool with a real request; --fix repairs settings" },
+  { name: "connect", usage: "connect", about: "Connect more tools" },
+  { name: "disconnect", usage: "disconnect", about: "Put tools back as they were and revoke their keys" },
+  { name: "key", usage: "key <tool> [--show]", about: "Copy a tool\u2019s key to the clipboard" },
+  { name: "home", usage: "home", about: "Show your tools, spend and balance again" },
+  { name: "clear", usage: "clear", about: "Clear the screen" },
+  { name: "help", usage: "help", about: "This list" },
+  { name: "exit", usage: "exit", about: "Leave (or press Ctrl+D)" }
+];
+var EXIT_WORDS = /* @__PURE__ */ new Set(["exit", "quit", "q", ":q", "bye"]);
+function splitLine(line) {
+  const words = [];
+  let word = "";
+  let quote = null;
+  let started = false;
+  for (const char of line.trim()) {
+    if (quote) {
+      if (char === quote) quote = null;
+      else word += char;
+      continue;
+    }
+    if (char === '"' || char === "'") {
+      quote = char;
+      started = true;
+      continue;
+    }
+    if (/\s/.test(char)) {
+      if (started || word) words.push(word);
+      word = "";
+      started = false;
+      continue;
+    }
+    word += char;
+  }
+  if (started || word) words.push(word);
+  if (words[0] === "npx") words.shift();
+  if (words[0] === "fullsendai" || words[0]?.startsWith("fullsendai@")) words.shift();
+  return words;
+}
+function complete(line, context) {
+  const words = line.split(/\s+/);
+  const current = words.at(-1) ?? "";
+  if (words.length <= 1) {
+    const names = SHELL_COMMANDS.map((command) => command.name);
+    const hits2 = names.filter((name) => name.startsWith(current));
+    return [(hits2.length ? hits2 : names).map((name) => `${name} `), current];
+  }
+  const options = {
+    model: context.models,
+    key: [...context.tools, "--show"],
+    doctor: ["--fix"],
+    connect: ["--tools", "--model", "--dry-run"],
+    disconnect: ["--tools", "--keep-keys"]
+  };
+  const choices = options[words[0]] ?? [];
+  const hits = choices.filter((choice) => choice.startsWith(current));
+  return [hits.map((hit) => `${hit} `), current];
+}
+function suggest(word) {
+  const distance = (a, b) => {
+    const row2 = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i++) {
+      let previous = row2[0];
+      row2[0] = i;
+      for (let j = 1; j <= b.length; j++) {
+        const current = row2[j];
+        row2[j] = Math.min(row2[j] + 1, row2[j - 1] + 1, previous + (a[i - 1] === b[j - 1] ? 0 : 1));
+        previous = current;
+      }
+    }
+    return row2[b.length];
+  };
+  const best = SHELL_COMMANDS.map((command) => ({ name: command.name, far: distance(word.toLowerCase(), command.name) })).sort((a, b) => a.far - b.far)[0];
+  return best && best.far <= 2 ? best.name : void 0;
+}
+
 // src/state.ts
 import { spawnSync } from "node:child_process";
 import { mkdirSync as mkdirSync2 } from "node:fs";
@@ -10218,6 +10305,23 @@ var cyan = paint(36, 39);
 var volt = (text) => colour ? `\x1B[38;5;154m${text}\x1B[39m` : text;
 var sym = unicode ? { ok: "\u2713", fail: "\u2717", warn: "!", dot: "\xB7", arrow: "\u203A", on: "\u25C9", off: "\u25CB", pointer: "\u276F", line: "\u2500", skip: "\u2013" } : { ok: "+", fail: "x", warn: "!", dot: "-", arrow: ">", on: "(*)", off: "( )", pointer: ">", line: "-", skip: "-" };
 var jsonMode = false;
+var shellMode = false;
+function setShell(on) {
+  shellMode = on;
+}
+var Cancelled = class extends Error {
+  constructor() {
+    super("Cancelled.");
+  }
+};
+var cmd = (rest) => shellMode ? rest : `npx fullsendai ${rest}`;
+function interrupt(reject) {
+  if (!shellMode) {
+    restoreTerminal();
+    process.exit(130);
+  }
+  reject(new Cancelled());
+}
 function setJson2(on) {
   jsonMode = on;
 }
@@ -10233,7 +10337,7 @@ function row(state, name, detail = "", width = 14) {
 }
 function header2(title, sub) {
   print();
-  print(`  ${volt(bold("FullsendAI"))} ${dim(sym.dot)} ${title}`);
+  print(shellMode ? `  ${bold(title.charAt(0).toUpperCase() + title.slice(1))}` : `  ${volt(bold("FullsendAI"))} ${dim(sym.dot)} ${title}`);
   if (sub) print(`  ${dim(sub)}`);
   print();
 }
@@ -10263,24 +10367,27 @@ async function ask(question, secret = false) {
   return readLine(secret);
 }
 function readLine(secret = false) {
-  return new Promise((resolve) => {
+  return new Promise((resolve, reject) => {
     const input = process.stdin;
     let value = "";
     input.setRawMode?.(true);
     input.resume();
     input.setEncoding("utf8");
-    const done = (result) => {
+    const stop = () => {
       input.setRawMode?.(false);
       input.pause();
       input.off("data", onData);
       out.write("\n");
+    };
+    const done = (result) => {
+      stop();
       resolve(result);
     };
     const onData = (chunk) => {
       for (const char of chunk) {
         if (char === "") {
-          restoreTerminal();
-          process.exit(130);
+          stop();
+          return interrupt(reject);
         }
         if (char === "\r" || char === "\n") return done(value);
         if (char === "\x7F" || char === "\b") {
@@ -10325,17 +10432,23 @@ async function checklist(question, choices) {
   process.stdin.resume();
   out.write("\x1B[?25l");
   draw(true);
-  return new Promise((resolve) => {
+  return new Promise((resolve, reject) => {
     const move = (step) => {
       for (let tries = 0; tries < choices.length; tries++) {
         at = (at + step + choices.length) % choices.length;
         if (!choices[at].disabled) break;
       }
     };
+    const stop = () => {
+      process.stdin.off("keypress", onKey);
+      process.stdin.setRawMode?.(false);
+      process.stdin.pause();
+      out.write("\x1B[?25h");
+    };
     const onKey = (text, key2 = {}) => {
       if (key2.ctrl && key2.name === "c") {
-        restoreTerminal();
-        process.exit(130);
+        stop();
+        return interrupt(reject);
       }
       if (key2.name === "up" || text === "k") move(-1);
       else if (key2.name === "down" || text === "j") move(1);
@@ -10344,10 +10457,7 @@ async function checklist(question, choices) {
         const all = choices.filter((choice) => !choice.disabled).every((choice) => choice.checked);
         for (const choice of choices) if (!choice.disabled) choice.checked = !all;
       } else if (key2.name === "return" || key2.name === "enter") {
-        process.stdin.off("keypress", onKey);
-        process.stdin.setRawMode?.(false);
-        process.stdin.pause();
-        out.write("\x1B[?25h");
+        stop();
         return resolve(chosen());
       }
       draw(false);
@@ -10378,19 +10488,22 @@ async function select(question, options, initial) {
   process.stdin.resume();
   out.write("\x1B[?25l");
   draw(true);
-  return new Promise((resolve) => {
+  return new Promise((resolve, reject) => {
+    const stop = () => {
+      process.stdin.off("keypress", onKey);
+      process.stdin.setRawMode?.(false);
+      process.stdin.pause();
+      out.write("\x1B[?25h");
+    };
     const onKey = (text, key2 = {}) => {
       if (key2.ctrl && key2.name === "c") {
-        restoreTerminal();
-        process.exit(130);
+        stop();
+        return interrupt(reject);
       }
       if (key2.name === "up" || text === "k") at = (at - 1 + options.length) % options.length;
       else if (key2.name === "down" || text === "j") at = (at + 1) % options.length;
       else if (key2.name === "return" || key2.name === "enter") {
-        process.stdin.off("keypress", onKey);
-        process.stdin.setRawMode?.(false);
-        process.stdin.pause();
-        out.write("\x1B[?25h");
+        stop();
         return resolve(options[at].id);
       }
       draw(false);
@@ -10416,6 +10529,7 @@ async function main(argv) {
   const w = here();
   const origin = (flags.url ?? w.env.FULLSENDAI_URL ?? DEFAULT_ORIGIN).replace(/\/+$/, "");
   const api = new Api(origin);
+  if (!command) return interactive && !flags.json ? shell(api, origin, flags) : connect(api, origin, flags);
   switch (command) {
     case "connect":
       return connect(api, origin, flags);
@@ -10462,7 +10576,7 @@ async function connect(api, origin, flags) {
     for (const { tool, found: found2 } of installed) row("ok", tool.name, dim([found2.version, found2.how].filter(Boolean).join(sym.dot === "\xB7" ? " \xB7 " : " - ")));
     print();
   } else {
-    print(`  Found ${installed.length === 1 ? "1 coding tool" : `${installed.length} coding tools`}. What each uses now is backed up, and ${cyan("npx fullsendai disconnect")} brings it back.`);
+    print(`  Found ${installed.length === 1 ? "1 coding tool" : `${installed.length} coding tools`}. What each uses now is backed up, and ${cyan(cmd("disconnect"))} brings it back.`);
     print();
   }
   const chosen = flags.tools ? flags.tools : await checklist(
@@ -10514,7 +10628,7 @@ async function connect(api, origin, flags) {
   if (ask2) print();
   const modelId = ask2 ? await select("Which model should your tools use?", modelOptions(models.value, suggested), suggested) : suggested;
   const chosenModel = models.value.find((model2) => model2.id === modelId);
-  print(`  Model for all tools: ${bold(chosenModel?.name ?? modelId)} ${dim(`(${modelId} \xB7 change any time with: npx fullsendai model)`)}`);
+  print(`  Model for all tools: ${bold(chosenModel?.name ?? modelId)} ${dim(`(${modelId} \xB7 change any time with: ${cmd("model")})`)}`);
   print();
   const folder = backupFolder(w);
   const ctx = { w, origin, base: `${origin}/v1`, model: modelId, models: models.value };
@@ -10571,7 +10685,7 @@ async function connect(api, origin, flags) {
   if (unpaid) {
     print(`  ${yellow(bold("Add credit to start."))} Your FullsendAI balance is empty, so the test calls were refused.`);
     print(`  Your tools are set up and work as soon as you add credit at ${cyan(`${origin}/dashboard/billing`)}.`);
-    print(`  ${dim("Then check them with: npx fullsendai doctor")}`);
+    print(`  ${dim(`Then check them with: ${cmd("doctor")}`)}`);
     print();
   }
   if (good) {
@@ -10590,7 +10704,8 @@ async function connect(api, origin, flags) {
       print(`    ${dim(`Cap what a tool can spend: ${origin.replace(/^https?:\/\//, "")}/dashboard/keys, then that tool's key, Monthly spend cap.`)}`);
     }
     print();
-    print(`  ${dim(`Backups: ${short(folder, w.home)}   ${sym.dot} Spend per tool: npx fullsendai status   ${sym.dot} Undo: npx fullsendai disconnect`)}`);
+    print(`  ${dim(`Backups: ${short(folder, w.home)}   ${sym.dot} Spend per tool: ${cmd("status")}   ${sym.dot} Undo: ${cmd("disconnect")}`)}`);
+    await offerInstall(flags);
   }
   saveState(w, { ...loadState(w, origin), catalog: fingerprint(models.value) });
   return output(flags, { connected: results.filter((result) => result.ok).map((result) => result.id), guided: guided.map((tool) => tool.id), failed: results.filter((result) => !result.ok), model: modelId, backups: folder }, results.some((result) => !result.ok) ? 1 : 0);
@@ -10627,7 +10742,7 @@ async function showGuide(tool, ctx, secret, w) {
   print(`  ${bold(tool.name)} ${dim("keeps its settings in the app. Three steps:")}`);
   guide.steps.forEach((step, index) => print(`    ${dim(`${index + 1}.`)} ${step}`));
   const copied = interactive && await confirm(`Copy ${tool.name}'s key to the clipboard now?`) && copy(secret, w);
-  for (const [label, value] of guide.values) print(`       ${dim(label.padEnd(26))} ${value.includes("clipboard") ? copied ? green("copied to your clipboard") : `run ${cyan(`npx fullsendai key ${tool.id}`)} to copy it` : cyan(value)}`);
+  for (const [label, value] of guide.values) print(`       ${dim(label.padEnd(26))} ${value.includes("clipboard") ? copied ? green("copied to your clipboard") : `run ${cyan(cmd(`key ${tool.id}`))} to copy it` : cyan(value)}`);
 }
 async function status(api, origin, flags) {
   const w = here();
@@ -10635,7 +10750,7 @@ async function status(api, origin, flags) {
   const ids = Object.keys(state.tools);
   header2("status", state.account?.email ? `Signed in as ${state.account.email}` : void 0);
   if (!ids.length) {
-    print(`  No tools are connected yet. Run ${cyan("npx fullsendai connect")}.`);
+    print(`  No tools are connected yet. Run ${cyan(cmd("connect"))}.`);
     return output(flags, { tools: [] }, 0);
   }
   const report = await spin(
@@ -10654,7 +10769,7 @@ async function status(api, origin, flags) {
   for (const { tool, connection, reading, info } of report) {
     if (info.ok) balance = info.value.balance;
     const spend = info.ok ? `$${info.value.usage.toFixed(2)} this month${connection.given ? dim(" on your shared key") : ""}` : red(info.error);
-    const drift = reading && !reading.connected ? yellow(" \xB7 settings changed since connect (npx fullsendai doctor --fix)") : reading?.problem ? yellow(` \xB7 ${reading.problem}`) : "";
+    const drift = reading && !reading.connected ? yellow(` \xB7 settings changed since connect (${cmd("doctor --fix")})`) : reading?.problem ? yellow(` \xB7 ${reading.problem}`) : "";
     row(info.ok && !drift ? "ok" : "warn", tool?.name ?? "?", `${dim(reading?.model ?? connection.model)}  ${spend}${drift}`);
   }
   const byKey = new Map(report.flatMap(({ connection, info }) => info.ok ? [[connection.key, info.value.failovers ?? 0]] : []));
@@ -10675,14 +10790,14 @@ async function model(api, origin, wanted, flags) {
   const w = here();
   const state = loadState(w, origin);
   const ids = Object.keys(state.tools);
-  if (!ids.length) return fail("No tools are connected yet. Run npx fullsendai connect first.", flags);
+  if (!ids.length) return fail(`No tools are connected yet. Run ${cmd("connect")} first.`, flags);
   const models = await api.models(state.tools[ids[0]].key);
   if (!models.ok) return fail(models.error, flags);
   let id = wanted;
   if (!id) {
     header2("pick a model");
     const current = state.tools[ids[0]].model;
-    if (!interactive) return fail(`Name the model: npx fullsendai model <id>. Live models: ${models.value.map((option) => option.id).join(", ")}.`, flags);
+    if (!interactive) return fail(`Name the model: ${cmd("model <id>")}. Live models: ${models.value.map((option) => option.id).join(", ")}.`, flags);
     id = await select("Switch every tool to:", modelOptions(models.value, pickModel(models.value, void 0) ?? current).map((option) => option.id === current ? { ...option, tag: "current" } : option), current);
   }
   if (!id || !models.value.some((option) => option.id === id)) return fail(`There's no model called ${id ?? "(none)"}. Live models: ${models.value.map((option) => option.id).join(", ")}.`, flags);
@@ -10711,13 +10826,191 @@ async function model(api, origin, wanted, flags) {
   }
   return output(flags, { model: id }, 0);
 }
+async function shell(api, origin, flags) {
+  const w = here();
+  setShell(true);
+  if (!Object.keys(loadState(w, origin).tools).length) {
+    print();
+    print(`  ${volt(bold("FullsendAI"))} ${dim(sym.dot)} Welcome. Let\u2019s connect your coding tools first.`);
+    await guarded(() => connect(api, origin, { ...flags, json: false }));
+    if (!Object.keys(loadState(w, origin).tools).length) return 0;
+  }
+  const context = { models: [], tools: [] };
+  await home(api, origin, context);
+  const history = [];
+  for (; ; ) {
+    context.tools = Object.keys(loadState(w, origin).tools);
+    const line = await promptLine(history, context);
+    if (line === null) break;
+    const words = splitLine(line);
+    if (!words.length) continue;
+    if (history[0] !== line.trim()) history.unshift(line.trim());
+    if (EXIT_WORDS.has(words[0].toLowerCase())) break;
+    const parsed = parse4(words);
+    const given = { ...parsed.flags, json: false, url: flags.url };
+    const name = parsed.command ?? "";
+    await guarded(async () => {
+      switch (name) {
+        case "status":
+          return status(api, origin, given);
+        case "model":
+          return model(api, origin, parsed.args[0] ?? given.model, given);
+        case "sync":
+          return sync(api, origin, given);
+        case "doctor":
+          return doctor(api, origin, given);
+        case "connect":
+          await connect(api, origin, given);
+          return home(api, origin, context);
+        case "disconnect":
+          await disconnect(api, origin, given);
+          return home(api, origin, context);
+        case "key":
+          return key(origin, parsed.args[0], given);
+        case "home":
+          return home(api, origin, context);
+        case "clear":
+          process.stdout.write("\x1B[2J\x1B[3J\x1B[H");
+          return home(api, origin, context);
+        case "help":
+          return shellHelp();
+        case "version":
+          return print(`  ${VERSION}`);
+        default: {
+          const near = suggest(name);
+          print(`  ${yellow(sym.warn)} There\u2019s no \u201C${name}\u201D command.${near ? ` Did you mean ${cyan(near)}?` : ""} Type ${cyan("help")} for the list.`);
+        }
+      }
+    });
+  }
+  print(`  ${dim("See you soon. Type")} ${cyan("fullsendai")} ${dim("to come back.")}`);
+  return 0;
+}
+async function guarded(work) {
+  try {
+    await work();
+  } catch (error) {
+    if (error instanceof Cancelled) print(`  ${dim("Cancelled. Nothing changed.")}`);
+    else print(`  ${red(sym.fail)} ${error.message}`);
+  }
+  print();
+}
+async function home(api, origin, context) {
+  const w = here();
+  const state = loadState(w, origin);
+  const ids = Object.keys(state.tools);
+  print();
+  print(`  ${volt(bold("FullsendAI"))}${state.account?.email ? ` ${dim(sym.dot)} ${state.account.email}` : ""}`);
+  if (!ids.length) {
+    print();
+    print(`  No tools are connected. Type ${cyan("connect")} to start, or ${cyan("exit")} to leave.`);
+    print();
+    return;
+  }
+  const keys = [...new Set(ids.map((id) => state.tools[id].key))];
+  const [models, infos] = await spin("Loading your tools\u2026", () => Promise.all([api.models(keys[0]), Promise.all(keys.map((secret) => api.key(secret)))]));
+  if (models.ok) context.models = models.value.map((each) => each.id);
+  const info = new Map(keys.map((secret, index) => [secret, infos[index]]));
+  const first = infos.find((each) => each.ok);
+  const balance = first?.ok ? first.value.balance : void 0;
+  const allowance = first?.ok ? first.value.plan_allowance_remaining ?? 0 : 0;
+  if (balance !== void 0) print(`  ${dim("Balance")} ${balance <= 0 && allowance <= 0 ? yellow("$0.00, add credit to keep your tools working") : bold(`$${balance.toFixed(2)}`)}${allowance > 0 ? dim(`  + $${allowance.toFixed(2)} left in this month\u2019s plan`) : ""}`);
+  print();
+  const width = Math.max(...ids.map((id) => (toolById(id)?.name ?? id).length)) + 2;
+  const nameWidth = Math.min(26, Math.max(...ids.map((id) => modelName(models, state.tools[id].model).length)) + 2);
+  for (const id of ids) {
+    const connection = state.tools[id];
+    const result = info.get(connection.key);
+    const spend = result?.ok ? `$${result.value.usage.toFixed(2)} this month${connection.given ? " (shared key)" : ""}` : red(result?.error ?? "");
+    print(`  ${result?.ok ? green(sym.ok) : yellow(sym.warn)} ${bold((toolById(id)?.name ?? id).padEnd(width))}${modelName(models, connection.model).padEnd(nameWidth)}${dim(spend)}`);
+  }
+  const failovers = keys.reduce((sum, secret) => {
+    const result = info.get(secret);
+    return sum + (result?.ok ? result.value.failovers ?? 0 : 0);
+  }, 0);
+  if (failovers) print(`  ${volt(sym.ok)} ${failovers === 1 ? "1 call" : `${failovers} calls`} this month kept working when a provider failed.`);
+  await noticeChanges(api, origin, { yes: false, json: false, dryRun: false, keepKeys: false, show: false, fix: false }, false);
+  print();
+  print(`  ${dim("Type a command, or press Tab:")} ${["status", "model", "sync", "doctor", "connect", "disconnect", "key", "help", "exit"].map((name) => cyan(name)).join(dim(` ${sym.dot} `))}`);
+  print();
+}
+var modelName = (models, id) => models.ok ? models.value.find((each) => each.id === id)?.name ?? id : id;
+function promptLine(history, context) {
+  return new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: true,
+      history: [...history],
+      historySize: 200,
+      removeHistoryDuplicates: true,
+      completer: (line) => complete(line, context)
+    });
+    let settled = false;
+    const finish = (value) => {
+      if (settled) return;
+      settled = true;
+      rl.close();
+      if (value === null) process.stdout.write("\n");
+      resolve(value);
+    };
+    rl.on("line", (line) => finish(line));
+    rl.on("close", () => finish(null));
+    rl.on("SIGINT", () => {
+      if (rl.line) {
+        rl.write(null, { ctrl: true, name: "u" });
+        return;
+      }
+      process.stdout.write(`
+  ${dim("To leave, type exit or press Ctrl+D.")}
+`);
+      rl.prompt();
+    });
+    rl.setPrompt(`${volt("fullsendai")} ${dim(sym.arrow)} `);
+    rl.prompt();
+  });
+}
+function shellHelp() {
+  const width = Math.max(...SHELL_COMMANDS.map((command) => command.usage.length)) + 3;
+  print();
+  for (const command of SHELL_COMMANDS) print(`  ${cyan(command.usage.padEnd(width))}${command.about}`);
+  print();
+  print(`  ${dim("Tab completes commands, model IDs and tools. \u2191 and \u2193 go through what you typed. Ctrl+C cancels a step.")}`);
+}
+async function offerInstall(flags) {
+  const w = here();
+  if (!interactive || flags.yes || flags.json || fullsendaiInstalled(w)) return;
+  print();
+  if (!await confirm(`Install the ${cyan("fullsendai")} command, so you can open all this any time by typing just ${cyan("fullsendai")}?`)) {
+    print(`  ${dim("Any time later:")} ${cyan("npm install -g fullsendai")}`);
+    return;
+  }
+  const result = await spin("Installing the fullsendai command\u2026", () => npmInstall(w));
+  if (result.ok) {
+    print(`  ${green(sym.ok)} Installed. Type ${cyan(bold("fullsendai"))} in any terminal to open it.`);
+    return;
+  }
+  const denied = /EACCES|EPERM|permission denied/i.test(result.output);
+  print(`  ${yellow(sym.warn)} ${denied ? "npm needs admin rights to install commands on this computer." : "That didn\u2019t install."} Run this yourself:`);
+  print(`    ${cyan(w.platform === "win32" || !denied ? "npm install -g fullsendai" : "sudo npm install -g fullsendai")}`);
+}
+function npmInstall(w) {
+  return new Promise((resolve) => {
+    const child = spawn2(w.platform === "win32" ? "npm.cmd" : "npm", ["install", "-g", `fullsendai@${VERSION}`, "--no-fund", "--no-audit", "--loglevel=error"], { shell: w.platform === "win32", windowsHide: true });
+    let output2 = "";
+    child.stdout.on("data", (chunk) => output2 += chunk);
+    child.stderr.on("data", (chunk) => output2 += chunk);
+    child.on("error", (error) => resolve({ ok: false, output: error.message }));
+    child.on("close", (code) => resolve({ ok: code === 0, output: output2 }));
+  });
+}
 async function sync(api, origin, flags, quiet = false) {
   const w = here();
   const state = loadState(w, origin);
   const ids = Object.keys(state.tools);
   if (!quiet) header2("sync", "Brings each connected tool up to date with FullsendAI's models.");
   if (!ids.length) {
-    print(`  No tools are connected. Run ${cyan("npx fullsendai connect")}.`);
+    print(`  No tools are connected. Run ${cyan(cmd("connect"))}.`);
     return output(flags, { synced: [], moved: [] }, 0);
   }
   const models = await spin("Fetching the models\u2026", () => api.models(state.tools[ids[0]].key));
@@ -10764,7 +11057,7 @@ async function noticeChanges(api, origin, flags, apply) {
   print(`  ${yellow(sym.warn)} FullsendAI's models have changed since your tools were set up ${dim("(new or renamed models, abilities or prices)")}.`);
   const update = apply || interactive && !flags.json && await confirm("Update your tools now?");
   if (update) await sync(api, origin, flags, true);
-  else print(`  Run ${cyan("npx fullsendai sync")} to update them.`);
+  else print(`  Run ${cyan(cmd("sync"))} to update them.`);
 }
 var uidOf = (models, id) => models.find((model2) => model2.id === id)?.uid;
 function fingerprint(models) {
@@ -10777,7 +11070,7 @@ async function doctor(api, origin, flags) {
   header2("doctor", "Checking each connected tool's settings, key and a real request.");
   const ids = Object.keys(state.tools);
   if (!ids.length) {
-    print(`  No tools are connected. Run ${cyan("npx fullsendai connect")}.`);
+    print(`  No tools are connected. Run ${cyan(cmd("connect"))}.`);
     return output(flags, { problems: [] }, 0);
   }
   const problems = [];
@@ -10813,7 +11106,7 @@ async function doctor(api, origin, flags) {
   print();
   if (!open.length) print(`  ${green("Everything works.")}`);
   else if (!settings.length) print(`  ${yellow("Your balance is empty.")} Add credit at ${cyan(billing)}; the settings themselves are fine.`);
-  else print(`  ${yellow(`${open.length} problem${open.length > 1 ? "s" : ""}.`)} ${flags.fix ? "" : `Run ${cyan("npx fullsendai doctor --fix")} to repair settings.`}`);
+  else print(`  ${yellow(`${open.length} problem${open.length > 1 ? "s" : ""}.`)} ${flags.fix ? "" : `Run ${cyan(cmd("doctor --fix"))} to repair settings.`}`);
   return output(flags, { problems }, open.length ? 1 : 0);
 }
 async function disconnect(api, origin, flags) {
@@ -10858,7 +11151,7 @@ function key(origin, id, flags) {
   if (!id || !connection) return fail(`Name a connected tool: ${Object.keys(state.tools).join(", ") || "(none connected)"}.`, flags);
   if (flags.show) print(connection.key);
   else if (copy(connection.key, w)) print(`  ${green(sym.ok)} ${toolById(id)?.name}'s key is on your clipboard.`);
-  else print(`  No clipboard here. Run ${cyan(`npx fullsendai key ${id} --show`)} to print it.`);
+  else print(`  No clipboard here. Run ${cyan(cmd(`key ${id} --show`))} to print it.`);
   return output(flags, { tool: id }, 0);
 }
 function pickModel(models, wanted) {
@@ -10903,7 +11196,7 @@ function fileFor(tool, origin) {
   const reading = tool.read?.({ w: here(), origin, base: `${origin}/v1` });
   return reading?.file ?? "";
 }
-var short = (path, home) => path.startsWith(home) ? `~${path.slice(home.length)}` : path;
+var short = (path, home2) => path.startsWith(home2) ? `~${path.slice(home2.length)}` : path;
 var jsonOut;
 function output(flags, value, code) {
   if (flags.json) jsonOut = value;
@@ -10921,10 +11214,11 @@ function help() {
   print(`
   ${volt(bold("FullsendAI"))} ${dim(`v${VERSION}`)} ${dim("\xB7")} connect your coding tools in one command
 
-  ${bold("Usage")}  npx fullsendai <command> [options]
+  ${bold("Usage")}  fullsendai               Open FullsendAI: your tools, spend and every command
+         fullsendai <command>     Run one command (npx fullsendai <command> works too)
 
   ${bold("Commands")}
-    connect            Find your coding tools and connect them (default)
+    connect            Find your coding tools and connect them
     status             What's connected, each tool's model and spend this month
     model [id]         Switch every connected tool to another model
     doctor [--fix]     Check settings, keys and a real request; --fix repairs settings
@@ -10964,7 +11258,7 @@ function parse4(argv) {
     else if (name === "--help" || name === "-h") args.unshift("help");
     else args.push(arg);
   }
-  const command = args.shift() ?? "connect";
+  const command = args.shift();
   return { command, args, flags };
 }
 main(process.argv.slice(2)).then((code) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fullsendai",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Connect Claude Code, Codex, OpenCode, Aider, Continue and more to FullsendAI in one command.",
   "keywords": ["fullsendai", "claude-code", "codex", "opencode", "aider", "continue", "cline", "cursor", "llm", "cli"],
   "homepage": "https://fullsendai.com/docs/agents",