summon-cli

Terminal launcher for local AI CLIs. Run summon, pick a tool, launch it.

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.4.0).

Install

npm install -g summon-cli

First run

The first launch walks you through a one-time setup (and keeps asking until you finish it):

summon

Two steps:

1. Command name — pick what you'll type to open the launcher. The default is cli; summon always keeps working. Picking cli (or a custom name) installs a small shim in ~/.local/bin.
2. Side logo — show the animated logo next to the menu, or keep it compact.

Your choices are saved to the config. Re-run the wizard anytime:

summon setup

If ~/.local/bin isn't on your PATH, the wizard tells you — add it so your new command name resolves:

export PATH="$HOME/.local/bin:$PATH"   # add to ~/.zshrc or ~/.bashrc

Daily use

Open the picker and launch a tool:

cli            # or: summon

• Move — ↑/↓, j/k, or 1–9
• Launch — Enter
• Quit — Esc

Missing tools show dimmed. The side logo hides automatically on small terminals.

Pass arguments straight through to the launched tool with --:

cli -- --version

Customize

Add your own CLI with an interactive form (one field at a time — command, name, subtitle):

cli add

Fill each field, then Enter on the last one to save…


…and it shows up in the picker.

Or add one in a single line:

cli --add grok "Grok Build"     # runs `grok`, shows as "Grok Build"
cli --remove grok               # remove it again

Set the order tools appear in, or where the cursor starts:

cli reorder                     # arrange the list
cli default claude              # open with the cursor on Claude
cli default off                 # clear it

Toggle the side logo without re-running setup (remembered):

cli --logo
cli --no-logo

Install an extra command name for the launcher at any time:

cli alias zap                   # now `zap` opens it too

Commands & flags

cli                  open the picker
cli reorder          set the order tools appear in
cli default [tool]   start the cursor on <tool> (off clears, no arg = pick)
cli alias <name>     install another shell command name for the launcher
cli add              add a custom CLI via an interactive form
cli setup            re-run the first-run setup (command name + logo)
cli help             show help

--add [cmd] [label]  add a custom CLI (no args opens the form)
--remove <id>        remove a custom CLI
--logo / --no-logo   show / hide the side logo (remembered)
-- <args...>         pass everything after -- to the launched tool

Config

~/.config/summon-cli/config.json

Holds your order, default tool, custom tools, logo preference, and the setup flag. Safe to delete — the next run rebuilds it and re-runs setup.

Requirements

Node 18+, a TrueColor terminal, and the target CLIs on your PATH.

Trademarks

Unofficial, not affiliated with Codex CLI, Claude Code, Antigravity CLI, Cursor CLI, GitHub Copilot CLI, opencode CLI or their makers. Names, logos, colors belong to their owners and are used only to identify what you launch. Open an issue to request changes.

License

GPL-3.0-only. See LICENSE. Copyright (c) 2026 sk1gl4a.