summon-cli 0.1.0 → 0.3.0

package/README.md

@@ -6,9 +6,9 @@
 
 Terminal launcher for local AI CLIs. Run `summon`, pick a tool, launch it.
 
-Supported: Codex CLI, Claude Code, Antigravity CLI, Cursor CLI, GitHub Copilot CLI, opencode CLI. Missing tools show dimmed.
+Built-in: Codex CLI, Claude Code, Antigravity CLI, Cursor CLI, GitHub Copilot CLI, opencode CLI. Missing tools show dimmed. Add your own with `--add`.
 
-> Pre-release (0.1.0).
+> Pre-release (0.2.0).
 
 ## Install
 
@@ -21,14 +21,22 @@ Move with arrows or `j/k` or `1-9`. `Enter` launches, `Esc` quits.
 
 ## Commands
 
-- `summon` open the picker (or your default)
-- `summon menu` always open the picker
+- `summon` open the picker
 - `summon reorder` set the order
-- `summon default <tool>` launch one directly (`off` clears, no arg = pick)
-- `summon alias <name>` add another command name (e.g. `summon alias cli`)
+- `summon default <tool>` start the cursor on it (`off` clears, no arg = pick)
+- `summon alias <name>` install a second shell command name for the launcher
 - `summon help`
 
-Flag: `--no-logo`. Args after `--` go to the launched tool.
+## Flags
+
+- `--add <cmd> [label]` add a custom CLI to the menu. Example:
+  ```sh
+  summon --add grok "Grok Build"
+  ```
+  Adds an entry that runs `grok` and shows as `Grok Build` with hint `Custom provider`.
+- `--remove <id>` remove a custom CLI from the menu.
+- `--no-logo` / `--logo` toggle the side logo (remembered).
+- Args after `--` go to the launched tool.
 
 ## Config
 

package/bin/cli.mjs

@@ -23,11 +23,18 @@ const args = rawArgs.filter(arg => !arg.startsWith('-'));
 const command = args[0];
 
 const config = loadConfig();
-const logo = flags.has('--no-logo') ? false : (flags.has('--logo') || config.logo);
-const items = orderTools(config.order);
+let logo = config.logo;
+if (flags.has('--no-logo')) {
+  logo = false;
+  saveConfig({logo: false});
+} else if (flags.has('--logo')) {
+  logo = true;
+  saveConfig({logo: true});
+}
+const items = orderTools(config.order, config.customTools);
 
 if (process.env.CLI_LEVEL_SNAPSHOT === '1') {
-  process.stdout.write(renderSnapshot(Number(process.env.CLI_LEVEL_ACTIVE || 0)));
+  process.stdout.write(renderSnapshot(Number(process.env.CLI_LEVEL_ACTIVE || 0), items));
   process.exit(0);
 }
 
@@ -36,6 +43,16 @@ if (flags.has('--help') || flags.has('-h') || command === 'help') {
   process.exit(0);
 }
 
+if (flags.has('--add')) {
+  runAdd(args[0], args[1]);
+  process.exit(0);
+}
+
+if (flags.has('--remove') || flags.has('--rm')) {
+  runRemove(args[0]);
+  process.exit(0);
+}
+
 const canRenderTui = Boolean(process.stdin.isTTY && process.stdout.isTTY && process.env.TERM !== 'dumb');
 
 switch (command) {
@@ -48,29 +65,17 @@ switch (command) {
   case 'alias':
     runAlias(args[1]);
     break;
-  case 'menu':
-    await runMenu({forceMenu: true});
-    break;
   case undefined:
-    await runMenu({forceMenu: false});
+    await runMenu();
     break;
   default:
     process.stderr.write(`${PROG}: unknown command '${command}'. Try '${PROG} --help'.\n`);
     process.exit(2);
 }
 
-async function runMenu({forceMenu}) {
-  if (!forceMenu && config.default) {
-    const tool = tools.find(item => item.id === config.default);
-    if (tool && commandExists(tool.command)) {
-      process.exitCode = await runCommand(tool.command, forwardedArgs);
-      return;
-    }
-    process.stderr.write(`${PROG}: default '${config.default}' unavailable, opening menu.\n`);
-  }
-
+async function runMenu() {
   if (!canRenderTui) {
-    process.stdout.write(renderSnapshot(0));
+    process.stdout.write(renderSnapshot(0, items));
     process.stderr.write(`${PROG}: interactive terminal required for selection.\n`);
     process.exit(2);
   }
@@ -91,6 +96,7 @@ async function runReorder() {
   const order = await new Promise(resolve => {
     let instance;
     instance = render(React.createElement(ReorderApp, {
+      items,
       onCancel: () => {
         instance.unmount();
         resolve(null);
@@ -114,7 +120,7 @@ async function runReorder() {
 async function runDefault(target) {
   if (target === 'off' || target === 'none') {
     saveConfig({default: null});
-    process.stdout.write(`Default cleared. '${PROG}' now opens the menu.\n`);
+    process.stdout.write(`Default cleared. The cursor starts on the first tool.\n`);
     return;
   }
 
@@ -125,7 +131,7 @@ async function runDefault(target) {
       process.exit(2);
     }
     saveConfig({default: tool.id});
-    process.stdout.write(`Default set to ${tool.label}. '${PROG}' now launches it directly (use '${PROG} menu' for the picker).\n`);
+    process.stdout.write(`Default set to ${tool.label}. The menu now opens with the cursor on it.\n`);
     return;
   }
 
@@ -137,7 +143,49 @@ async function runDefault(target) {
     return;
   }
   saveConfig({default: selected.id});
-  process.stdout.write(`Default set to ${selected.label}. '${PROG}' now launches it directly (use '${PROG} menu' for the picker).\n`);
+  process.stdout.write(`Default set to ${selected.label}. The menu now opens with the cursor on it.\n`);
+}
+
+function runAdd(name, label) {
+  if (!name || !/^[a-zA-Z0-9._-]+$/.test(name)) {
+    process.stderr.write(`${PROG}: usage: ${PROG} --add <command> [label]\n`);
+    process.exit(2);
+  }
+
+  const id = name.toLowerCase();
+  if (tools.some(t => t.id === id)) {
+    process.stderr.write(`${PROG}: '${id}' is a built-in tool already.\n`);
+    process.exit(2);
+  }
+
+  const current = loadConfig().customTools || [];
+  if (current.some(t => t.id === id)) {
+    process.stderr.write(`${PROG}: '${id}' is already in your list.\n`);
+    process.exit(2);
+  }
+
+  const labelText = label || (name.charAt(0).toUpperCase() + name.slice(1));
+  const next = [...current, {id, label: labelText, command: name, hint: 'Custom provider'}];
+  saveConfig({customTools: next});
+  process.stdout.write(`Added '${labelText}' (command: ${name}) to the menu.\n`);
+}
+
+function runRemove(name) {
+  if (!name) {
+    process.stderr.write(`${PROG}: usage: ${PROG} --remove <id>\n`);
+    process.exit(2);
+  }
+
+  const id = name.toLowerCase();
+  const current = loadConfig().customTools || [];
+  const next = current.filter(t => t.id !== id);
+  if (next.length === current.length) {
+    process.stderr.write(`${PROG}: no custom tool '${id}'. List: ${current.map(t => t.id).join(', ') || '(none)'}.\n`);
+    process.exit(2);
+  }
+
+  saveConfig({customTools: next});
+  process.stdout.write(`Removed '${id}'.\n`);
 }
 
 function runAlias(name) {
@@ -165,6 +213,7 @@ function chooseTool() {
     instance = render(React.createElement(App, {
       items,
       logo,
+      initialId: config.default,
       onCancel: () => {
         instance.unmount();
         resolve(null);
@@ -239,16 +288,17 @@ function printHelp() {
 Summon your AI CLI. A terminal launcher.
 
 Commands:
-  (none)            Open the picker, or launch your default if one is set
-  menu              Always open the picker (ignore the default)
+  (none)            Open the picker
   reorder           Set the order tools appear in
-  default [tool]    Launch <tool> directly on '${PROG}'; no tool = pick one;
-                    'off' clears it
-  alias <name>      Install a second command name for this launcher
+  default [tool]    Start the cursor on <tool>; no tool = pick one; 'off' clears
+  alias <name>      Install a second shell command name for this launcher
   help              Show this help
 
 Options:
-  --no-logo         Hide the side logo (shown by default)
+  --add <cmd> [lbl] Add a custom CLI to the menu (e.g. --add grok "Grok Build")
+  --remove <id>     Remove a custom CLI from the menu
+  --no-logo         Hide the side logo and remember it
+  --logo            Show the side logo and remember it
 
 Anything after -- is passed to the launched tool, e.g. ${PROG} -- --version
 Config: ${configLocation()}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summon-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Summon your AI CLI. Terminal launcher for Codex CLI, Claude Code, Antigravity CLI, Cursor CLI, GitHub Copilot CLI, and opencode CLI.",
   "type": "module",
   "bin": {

package/src/app.mjs

@@ -149,10 +149,13 @@ function LogoPanel({tool}) {
   );
 }
 
-export function App({items = tools, logo = false, onSelect, onCancel}) {
+export function App({items = tools, logo = false, initialId = null, onSelect, onCancel}) {
   const {exit} = useApp();
   const {stdout} = useStdout();
-  const [active, setActive] = useState(0);
+  const [active, setActive] = useState(() => {
+    const idx = items.findIndex(tool => tool.id === initialId);
+    return idx >= 0 ? idx : 0;
+  });
   const [tick, setTick] = useState(0);
   const [spin, setSpin] = useState(0);
   const [flash, setFlash] = useState(0);
@@ -246,15 +249,15 @@ export function App({items = tools, logo = false, onSelect, onCancel}) {
   );
 }
 
-export function ReorderApp({onDone, onCancel}) {
+export function ReorderApp({items = tools, onDone, onCancel}) {
   const {exit} = useApp();
   const [order, setOrder] = useState([]);
   const [active, setActive] = useState(0);
 
   const seekUnpicked = (from, dir, taken) => {
-    for (let step = 0; step <= tools.length; step += 1) {
-      const index = (from + dir * step + tools.length * (step + 1)) % tools.length;
-      if (!taken.has(tools[index].id)) {
+    for (let step = 0; step <= items.length; step += 1) {
+      const index = (from + dir * step + items.length * (step + 1)) % items.length;
+      if (!taken.has(items[index].id)) {
         return index;
       }
     }
@@ -287,13 +290,13 @@ export function ReorderApp({onDone, onCancel}) {
     }
 
     if (key.return) {
-      const id = tools[active].id;
+      const id = items[active].id;
       if (taken.has(id)) {
         return;
       }
 
       const next = [...order, id];
-      if (next.length === tools.length) {
+      if (next.length === items.length) {
         exit();
         onDone(next);
         return;
@@ -311,7 +314,7 @@ export function ReorderApp({onDone, onCancel}) {
         React.createElement(Text, {color: dimGray}, '  pick first to last')
       ),
       React.createElement(Box, {flexDirection: 'column', gap: 0},
-        tools.map((tool, index) => {
+        items.map((tool, index) => {
           const pos = order.indexOf(tool.id);
           const picked = pos >= 0;
           const isActive = index === active && !picked;
@@ -506,9 +509,10 @@ function renderPlainLine(tool, index, activeIndex) {
   return `${arrow} ${label.padEnd(16)} ${tool.hint}`;
 }
 
-export function renderSnapshot(activeIndex = 0) {
-  const bounded = Math.max(0, Math.min(tools.length - 1, activeIndex));
-  return `${tools.map((tool, index) => renderPlainLine(tool, index, bounded)).join('\n')}\n`;
+export function renderSnapshot(activeIndex = 0, items = null) {
+  const list = items || tools;
+  const bounded = Math.max(0, Math.min(list.length - 1, activeIndex));
+  return `${list.map((tool, index) => renderPlainLine(tool, index, bounded)).join('\n')}\n`;
 }
 
 function commandExists(command) {
@@ -542,8 +546,26 @@ function nextAvailable(current, availability, items) {
 }
 
 // Reorder canonical tools by an array of ids; unknown ids ignored, missing appended.
-export function orderTools(order = []) {
-  const byId = new Map(tools.map(tool => [tool.id, tool]));
+export function buildCustomTool({id, label, command, hint, palette} = {}) {
+  if (!id) return null;
+  return {
+    id,
+    label: label || id,
+    command: command || id,
+    hint: hint || 'Custom provider',
+    palette: palette && palette.length ? palette : ['#9aa0a6', '#cdcdcd']
+  };
+}
+
+export function orderTools(order = [], customTools = []) {
+  const all = [...tools];
+  for (const raw of customTools) {
+    const tool = buildCustomTool(raw);
+    if (!tool) continue;
+    if (all.some(t => t.id === tool.id)) continue;
+    all.push(tool);
+  }
+  const byId = new Map(all.map(tool => [tool.id, tool]));
   const result = [];
   for (const id of order) {
     if (byId.has(id)) {
@@ -551,7 +573,7 @@ export function orderTools(order = []) {
       byId.delete(id);
     }
   }
-  for (const tool of tools) {
+  for (const tool of all) {
     if (byId.has(tool.id)) {
       result.push(tool);
     }

package/src/config.mjs

@@ -8,7 +8,8 @@ const configPath = join(baseDir, 'summon-cli', 'config.json');
 const DEFAULTS = {
   order: [],
   logo: true,
-  default: null
+  default: null,
+  customTools: []
 };
 
 export function loadConfig() {