All notable changes to this project are documented here. The format is based on Keep a Changelog.
- Added explicit type-check and dependency-audit scripts, weekly Dependabot coverage for npm and
GitHub Actions, and a pinned npm install-script approval policy. Updated
actions/setup-nodeto its current major release while retaining immutable action references.
- Expanded the README and agent guidance with requirements, quick start, environment handling, development commands, build steps, release distribution, and supply-chain conventions.
- Updated the locked Node.js type definitions within the existing Node 22 compatibility range.
- Restricted external installation documentation to credential-free HTTPS URLs and rejected unknown custom-agent settings at the configuration-schema boundary.
- Isolated Agent Doctor runner failures so one malformed or unavailable version command cannot abort the complete report.
- Made executable detection honor each custom agent's configured environment overrides.
- Removed the integration suite's remaining dependency on
vscode.window.terminalsarray order by matching newly created terminals by identity and name. - Excluded local environment files, logs, coverage output, and generated VSIX files from packages.
- Updated the VS Code integration-test harness for the current macOS app executable layout, restoring
CI on Apple Silicon runners after the legacy
Electroncompatibility path was removed upstream. - Preserved a favorite when its built-in preset is hidden but a custom agent override with the same id remains available.
- Escaped backslashes before Markdown delimiters in Agent Doctor reports, preventing version output from breaking the generated table.
- Repaired corrupted shell code fences in the contributor guide and added a regression check for hidden control characters in repository documentation.
- Hardened GitHub Actions with immutable action references, concurrency controls, and job timeouts; clarified the contributor, pull-request, conduct, and private security-reporting guidance.
- Added explicit light- and dark-theme SVG variants for every built-in agent. Monochrome marks now render black on light themes and white on dark themes; Mistral Vibe keeps the official Mistral yellow-to-red palette in both variants.
-
Added built-in presets for Amp, OpenClaude, Oh My Pi, goose, Auggie CLI, Cline CLI, Codebuff, Continue CLI, Mistral Vibe, and Rovo Dev CLI, with verified launch/version/update commands where the vendors expose them, official installation documentation, and source-attributed compact marks.
Package-manager-specific update commands are intentionally omitted for OpenClaude, Continue, and Rovo Dev; Codebuff updates itself, while Amp does not document a version command. Gemini remains excluded because
agyis the existing Antigravity CLI preset, not a Gemini CLI alias.
-
Added Devin CLI (Cognition) as a built-in preset, launched with
devin, with its official installation documentation and the official Devin logomark.It intentionally ships without an update button or a version check. Devin's docs only document an update path for Homebrew (
brew upgrade --cask devin-cli) while the CLI also installs via a curl script or winget — the correct command depends on how it was installed, not on the platform, so an update button would fail for anyone who installed it another way. No--versionis documented either, so Agent Doctor reports the version as unavailable rather than guessing.
- Replaced the redundant
antigravityMarketplace keyword withdevin; the more specificgoogle antigravityandantigravity clikeywords already cover that search, and the keyword list was at its 30-entry limit.
- Running sessions now survive a window reload. VS Code keeps the terminal processes alive across a reload, but the extension host restarts with an empty registry, so agents that were still running disappeared from the Running group. Surviving terminals are now matched back to their agent and picked up again, marked reconnected — their original start time is gone with the previous session, so no duration is invented for them. A recovered session ends when its terminal closes; unlike a freshly launched one, its command can no longer be observed.
- Lowered the required VS Code version from
1.103back to1.93, the actual floor of the terminal APIs in use. The higher value was raised only to satisfy packaging validation and made the extension uninstallable on VS Code forks that track upstream at a delay (Cursor, Windsurf, Trae, and others).@types/vscodeis pinned to the same version so the compiler enforces that floor. - Documented which editors can run the extension: VS Code and forks that install from Open VSX or a
.vsix. Zed and JetBrains IDEs cannot — their extensions are Rust/WASM and JVM plugins respectively, so no.vsixwill load, regardless of configuration.
- Update All Agents could hang indefinitely. An update command that never exits on its own (one waiting on an interactive prompt, or a stalled download) left the run stuck behind a progress notification that couldn't be cancelled, silently skipping every remaining agent. Each update now also settles when its terminal is closed, the progress notification is cancellable, and the run stops rather than firing the remaining commands into a terminal that is gone. Cancelling stops Super CLI from starting further updates; a command already running in the terminal is left alone for you to deal with, which is why the terminal stays open.
- Update All Agents now uses one shared
Super CLI: updatesterminal instead of opening a separate terminal per agent, which previously left up to 14 terminals behind on a default install. An agent configured with its ownenvstill gets a dedicated terminal, so its update keeps running exactly as configured. - The completion summary now reports failures and early stops, not just the success count.
- Unified the sidebar tree and quick pick onto one
buildAgentGroups, replacing two grouping functions that had become identical implementations of the same logic.
- Added a workspace-folder picker for new launches when the working directory can't be inferred (no active editor, more than one folder in the workspace); canceling it falls back to the previous first-folder default, same as before this existed.
- Added a Restart button to each running session: stops it and relaunches the same agent in exactly the folder it originally started in, reusing that folder directly rather than re-resolving it, so it never re-prompts even in a multi-root workspace.
- Added Stop All to the Running group header, ending every active session in one action.
- Added Super CLI: Update All Agents to the sidebar toolbar, running every updatable agent's
update command in sequence — never more than one at a time — and skipping agents currently believed
to be missing from
PATH. - Promoted favorites to their own Favorites group at the top of the sidebar tree, alongside Running, Ready, and Setup required, instead of being pinned as unlabeled individual rows.
- Added support for multiple favorite agents. Star as many as you like from the sidebar or launcher;
Ctrl+Alt+Alaunches directly with exactly one favorite, opens a quick pick scoped to your favorites with several, or the full picker with none. The setting moved fromsuperCli.favoriteAgent(a single id) tosuperCli.favoriteAgents(an array); an existing favorite is migrated automatically, and the old setting is left in place — never cleared — so Settings Sync can't drop it on a machine still running an older version.
- Added a live "Running" section to the sidebar showing every active agent session and how long it has been running, with a click to bring its terminal back into focus and an inline button to stop it. It tracks only terminal lifecycle (open/close, and when the launched CLI command itself exits) and never reads terminal content.
- Added a one-time rating nudge shown after 20 successful launches, stored only in local extension state and never repeated regardless of the response.
- Resolved all reported dependency vulnerabilities in the build/release toolchain (
fast-uri,js-yaml,linkify-it,brace-expansion, all transitive through@vscode/vsce); none of these ship with or run inside the packaged extension.
- Added Qwen Code CLI as a built-in preset with an official SVG icon, verified installation
documentation, and the
qwen --versioncheck. - Added the official
kiro-cli update,command-code update,grok --version,command-code --version,droid --version,crush --version,hermes --version, andpi --versioncommands, verified against each CLI's official reference documentation.
- Corrected Pi's update command from the ambiguous
pi updateto the documented, unambiguouspi update --self, since barepi updatetargets package sources rather than the pi CLI itself. - Updated the Codex CLI, GitHub Copilot CLI, and Kilo CLI installation documentation links to their current canonical URLs after upstream redirects.
- Added Qoder CLI as a built-in preset with official light/dark SVG icons, verified installation
documentation, and the official
qodercli updatecommand. - Added verified official installation documentation links for Grok CLI, Antigravity CLI, Command Code, and MiMo Code so every built-in preset now opens its official setup guide when the CLI is not found.
- Hardened custom-agent configuration handling so malformed optional fields cannot break the sidebar, launcher, icons, or terminal creation.
- Reduced false missing-CLI prompts by requiring a shell-specific command-not-found diagnostic.
- Offered to save a favorite only after a terminal was actually launched.
- Kept user-defined overrides visible when their matching built-in preset is hidden.
- Improved executable detection for quoted Windows
PATHentries, directories, and executable permissions.
- Prevented Launch and Favorite actions from appearing on the Ready and Setup required group headers.
- Pinned the favorite agent above the sidebar groups with an always-visible star while keeping the remaining agents alphabetical within their status groups.
- Moved the maintainer-facing Super CLI brand asset reference from the Marketplace README to
docs/BRAND.md.
- Sorted agents alphabetically within sidebar status groups, launcher sections, and the built-in agent manager.
- Fixed the grouped sidebar actions so Launch, Favorite, Update, and Setup Guide consistently receive the selected agent instead of the surrounding tree node.
- Removed launch commands from the virtual Agent Doctor report so command-line credentials cannot be reproduced in its Markdown table.
- Improved Visual Studio Marketplace discovery with a concise search-focused display name and description, a complete 30-keyword map, and a product-specific homepage.
- Reworked the README opening, installation path, image descriptions, and FAQ around common Claude Code, Codex CLI, Google Antigravity, Kiro CLI, OpenClaw CLI, and VS Code search intents.
- Added Kiro CLI and OpenClaw CLI as platform-adaptive built-in presets, including verified official installation documentation, version checks, and transparent vendor-sourced marks.
- Added Manage Built-in Agents, a multi-select control for keeping the sidebar focused without editing settings by hand.
- Added Agent Doctor, an explicit local diagnostic with bounded version checks, WSL support, and a privacy-conscious virtual report.
- Switched from eager startup activation to view- and command-based activation.
- Expanded ready agent groups by default and collapsed setup-required agents to reduce visual noise.
- Extended custom agent configuration with adaptive
versionCommandvalues for Windows, macOS, and Linux.
- Added Kimi Code CLI (
kimi) to the built-in agent presets, with its verified official installation documentation and the officialkimi upgradecommand. - Added vendor-sourced, theme-aware SVG marks in the sidebar, Quick Pick, and terminal tabs, with a documented compact fallback where no suitable transparent vendor SVG is available.
- Added a native empty-state welcome with actions to enable built-ins or open settings.
- Replaced the inconsistent legacy artwork with the unified Router S identity across the Marketplace, activity bar, and editor toolbar, with larger optical sizing and color toolbar variants for light and dark themes.
- Refreshed the README, support guidance, brand-asset reference, citation metadata, and product screenshots to match the current agent groups, settings, icons, and Router S identity.
- Built-in and user-defined launch/update commands now resolve explicitly for Windows, macOS, or Linux. Existing cross-platform string commands remain supported, and WSL selects the Linux variant.
- Reorganized the sidebar and launcher into favorite, ready, unknown, and setup-required states; favorites can now be changed directly inside the launcher.
- Missing CLIs now offer their setup guide before launch, and terminal-integrated updates report completion or failure with a direct return to the update terminal.
- Removed all automatic CLI installation and generated installer execution. Missing supported CLIs now offer their verified official installation documentation in the external browser.
- Removed automatic agent configuration-file edits. VSIX contents continue to be defined solely by
.vscodeignore, without a competingfilesallowlist.
- Super CLI no longer runs npm installers, remote shell installers, or shell/profile modifications for agent CLIs.
- Improved legal documentation, trademark notices, third-party terms references, and metadata cleanup.
- Upgraded TypeScript from
^5.0.0to^7.0.0(resolved 7.0.2). No source or configuration changes were required. - Raised the minimum required VS Code version to
^1.103.0and aligned@types/vscodeto match, sovscevalidation passes against the declared engine floor.
- Resolved npm security vulnerabilities via
npm audit fix.
- Added Pi to the built-in agent presets. Pi (Pi Coding Agent) installs via the official npm
package
@earendil-works/pi-coding-agent(pibinary), with guided install and the officialpi updatecommand.
- Fixed the Droid install command. The
droidbuilt-in now installs the official scoped npm package@factory/cli(which provides thedroidbinary) instead of the incorrect unscopeddroidpackage. - Raised the minimum VS Code version to
^1.93.0, the actual floor for the terminal shell integration APIs the extension uses (the manifest previously declared^1.86.0). - Added
CONTRIBUTING.md,SECURITY.md,SUPPORT.md, andTRADEMARKS.mdgovernance documents, and compiled against theES2022target. No functional changes beyond the Droid fix.
- Docs. README updated to reflect 0.7.1: Cursor, Grok and Hermes now install natively on Windows (PowerShell), and Cursor, OpenCode and Droid show an update button. No functional changes.
- Verified every built-in CLI against current official sources and completed the install/update
presets:
- Native Windows installers added for Cursor, Grok, and Hermes (these now ship a PowerShell installer upstream, so guided install works on native Windows, not only under WSL).
- Update buttons added for Cursor (
cursor-agent update), OpenCode (opencode upgrade), and Droid (droid update), which now expose official update commands.
- No changes to commands or package names — claude, codex, copilot, kilo, crush (
@charmland/crush), command-code, antigravity, droid (droid), and mimo were all confirmed correct.
- Favorite agent. Mark an agent as your favorite with the star (★) button next to it in the
sidebar, and launch it from anywhere with
Ctrl+Alt+A(Cmd+Alt+Aon macOS; remappable in Keyboard Shortcuts). When no favorite is set, the shortcut opens the picker and offers to remember your choice. Stored in the newsuperCli.favoriteAgentsetting. - Install-status indicator. Agents whose CLI isn't found on your
PATHare shown dimmed and marked not installed (best-effort, no process spawned). Not shown undersuperCli.useWsl, since the WindowsPATHdoesn't reflect what's installed inside WSL.
- Added an Open VSX badge to the README (Super CLI is published on Open VSX for Cursor, Windsurf, VSCodium, and Gitpod users).
- Unified the
LICENSEcopyright holder to Michael Gasperini (Mikesoft). No functional changes.
- Marketplace discoverability: added the AI and Chat categories, a more descriptive title and summary, reordered keywords, and a FAQ in the README. No functional changes.
- Per-agent Update button. Each sidebar agent that has a known update command now shows an update
button next to Launch, which runs the CLI's official update (e.g.
codex update,copilot update,kilo upgrade,hermes update,claude update, npm reinstall for Crush). CLIs that update themselves (OpenCode, Cursor, Droid, MiMo Code, Command Code) don't show one. - New
updateCommandagent field carrying each CLI's official update command. - Removed the
superCli.autoUpdatesetting (added in 0.5.0): updating is now manual via the Update button, since most CLIs already self-update. superCli.useWsl(new): on Windows, open agents in a WSL terminal (native VS Code support); under WSL the agents use their Unix install/update commands.
- New
superCli.autoUpdatesetting (default on): each coding agent CLI is updated to its latest version on launch —npm install -gfor npm CLIs, or the official installer script for the others — before it starts. Turn it off to launch without updating.
- Claude Code no longer auto-installs its companion IDE extension when launched from Super CLI. The
launcher sets Claude Code's official
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALLenvironment variable on the agent's terminal — in keeping with Super CLI's "one extension for every CLI" philosophy. - New optional agent field
envto set environment variables for an agent's terminal.
- Added Cursor CLI (
cursor-agent), Droid CLI (droid), Crush (crush), Hermes (hermes), and MiMo Code (mimo) to the built-in agent presets. - Command Code no longer installs its companion editor extension when launched from Super CLI.
In keeping with Super CLI's "one extension for every CLI" philosophy, the launcher sets
autoInstallExtension: falsein~/.commandcode/config.json(Command Code's own official opt-out) before launching it — added only if you have not set the value yourself. - New optional agent field
ensureConfigto ensure a CLI's JSON config contains certain keys before launch (existing keys are never overwritten).
- Added a GitHub Sponsors link on the repository and the Marketplace listing.
- Added sidebar and settings screenshots to the README.
- Tidied documentation and metadata: keywords aligned to the built-in agents, and the per-OS
installCommandform is now documented.
- Command Code now launches with the
command-codecommand instead ofcmd, which Windows intercepts as the built-in Command Prompt. The new command works on Windows, macOS, Linux, and WSL.
- Added Command Code (
cmd, npmcommand-code) to the built-in presets. - Removed Gemini CLI: Google retired it on June 18, 2026 in favor of Antigravity CLI, which is already included. Antigravity now uses Gemini's former icon.
- Grok and Antigravity now offer a guided install using their official installer scripts.
installCommandcan now be OS-specific: it accepts either a string (cross-platform, e.g. npm) or an object withunixandwindowskeys. The guided install runs the resolved command directly in a terminal after the confirmation dialog.
- Kilo now installs from its official npm package (
@kilocode/cli), so it joins the guided-install flow. Grok and Antigravity are distributed as standalone binaries (no official npm package), so they keep launching without an auto-install offer.
- Added OpenCode to the built-in agent presets.
- Built-in CLIs that install from npm (Claude Code, Codex, Copilot, Gemini, OpenCode) now offer a
guided install with their official command when the command is not found. Grok, Kilo, and
Antigravity use OS-specific shell installers and are not auto-offered; add a custom
installCommandfor your platform if you want one.
- Initial release.
- Unified launcher for coding agent CLIs with a Super CLI sidebar view and a quick-pick command.
- Built-in presets: Claude Code, Codex, GitHub Copilot CLI, Gemini, Grok, Kilo, Antigravity.
- User-extensible agent registry via the
superCli.agentssetting, with id-based overrides of the built-ins. - Native integrated terminal launch with cross-platform missing-command detection and optional guided install.
- Themed monochrome activity-bar icon and a full-color toolbar/Marketplace icon.