summon-cli 0.2.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
 
@@ -24,10 +24,19 @@ Move with arrows or `j/k` or `1-9`. `Enter` launches, `Esc` quits.
 - `summon` open the picker
 - `summon reorder` set the order
 - `summon default <tool>` start the cursor on it (`off` clears, no arg = pick)
-- `summon alias <name>` add another command name (e.g. `summon alias cli`), or shortcut `summon --add <name>`
+- `summon alias <name>` install a second shell command name for the launcher
 - `summon help`
 
-Flags: `--no-logo` / `--logo` toggle the side logo (remembered). 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

@@ -31,10 +31,10 @@ if (flags.has('--no-logo')) {
   logo = true;
   saveConfig({logo: true});
 }
-const items = orderTools(config.order);
+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);
 }
 
@@ -44,7 +44,12 @@ if (flags.has('--help') || flags.has('-h') || command === 'help') {
 }
 
 if (flags.has('--add')) {
-  runAlias(args[0]);
+  runAdd(args[0], args[1]);
+  process.exit(0);
+}
+
+if (flags.has('--remove') || flags.has('--rm')) {
+  runRemove(args[0]);
   process.exit(0);
 }
 
@@ -70,7 +75,7 @@ switch (command) {
 
 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);
@@ -140,9 +146,51 @@ async function runDefault(target) {
   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) {
   if (!name || !/^[a-zA-Z0-9._-]+$/.test(name)) {
-    process.stderr.write(`${PROG}: usage: ${PROG} alias <name>  (or ${PROG} --add <name>)\n`);
+    process.stderr.write(`${PROG}: usage: ${PROG} alias <name>\n`);
     process.exit(2);
   }
 
@@ -243,12 +291,12 @@ Commands:
   (none)            Open the picker
   reorder           Set the order tools appear in
   default [tool]    Start the cursor on <tool>; no tool = pick one; 'off' clears
-  alias <name>      Install a second command name for this launcher
-                    (shortcut: ${PROG} --add <name>)
+  alias <name>      Install a second shell command name for this launcher
   help              Show this help
 
 Options:
-  --add <name>      Install a second command name (same as 'alias')
+  --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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summon-cli",
-  "version": "0.2.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

@@ -249,15 +249,15 @@ export function App({items = tools, logo = false, initialId = null, onSelect, on
   );
 }
 
-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;
       }
     }
@@ -290,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;
@@ -314,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;
@@ -509,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) {
@@ -545,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)) {
@@ -554,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() {