Release 0.6.0: per-agent Update button, accurate updates, WSL option

- Add a per-agent Update button in the sidebar (next to Launch) for agents that
  have a known update command: codex update, copilot update, kilo upgrade,
  hermes update, claude update, npm reinstall for Crush.
- New updateCommand agent field with each CLI's official update command. autoUpdate
  now runs it instead of a blind reinstall; self-updating CLIs run nothing.
- superCli.autoUpdate is now off by default (most CLIs self-update).
- New superCli.useWsl: on Windows, open agents in a WSL terminal (native VS Code
  support); under WSL agents use their Unix install/update commands.

Author: TheStreamCode

CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [0.6.0]
+
+- **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).
+- **Accurate updates.** New `updateCommand` agent field carries each CLI's official update command.
+  `superCli.autoUpdate` now runs that command instead of a blind reinstall; CLIs that update
+  themselves (OpenCode, Cursor, Droid, MiMo Code, Command Code) run nothing.
+- **`superCli.autoUpdate` is now off by default** — 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.
+
 ## [0.5.0]
 
 - New `superCli.autoUpdate` setting (default on): each coding agent CLI is updated to its latest

README.md

@@ -40,6 +40,10 @@ You can also open the Extensions view in VS Code (or Cursor, Antigravity, Windsu
   retired by Google and replaced by Antigravity.)
 - **Add your own, no code required.** Define new agents in `settings.json`. The sidebar updates
   automatically.
+- **Update from the sidebar.** Agents with a known update command show an update button next to
+  Launch, which runs the CLI's official update (e.g. `codex update`, `kilo upgrade`, `hermes update`).
+  CLIs that update themselves don't show one. The optional `superCli.autoUpdate` setting can run that
+  update on launch.
 - **Guided install.** If a built-in CLI isn't found, Super CLI offers to install it with its official
   command after explicit confirmation — npm for Claude Code, Codex, Copilot, Kilo, OpenCode, Command
   Code, Droid, Crush and MiMo Code, and the official installer script for Grok, Antigravity, Cursor
@@ -86,6 +90,10 @@ reuses a built-in `id` — overrides that built-in (for example to point at a cu
   "defaults": { "autoInstallExtension": false } }`.
 - `env` — optional environment variables set for the agent's terminal, e.g. to opt out of a CLI's
   IDE-extension auto-install via its own variable: `{ "CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL": "1" }`.
+- `updateCommand` — optional command to update the CLI (its official `update`/`upgrade` command, or
+  an npm reinstall). Adds an update button next to the agent in the sidebar, and is used by
+  `superCli.autoUpdate`. Like `installCommand`, it can be a string or an object with `unix`/`windows`
+  keys.
 
 Only the user (global) value of `superCli.agents` is used; workspace overrides are ignored so that
 an untrusted repository cannot inject commands.
@@ -97,7 +105,8 @@ an untrusted repository cannot inject commands.
 | `superCli.agents` | `[]` | Your agents (added to or overriding the built-ins). |
 | `superCli.useBuiltins` | `true` | Include the built-in agent presets. |
 | `superCli.terminalLocation` | `beside` | Open the terminal `beside` the editor or in the `panel`. |
-| `superCli.autoUpdate` | `true` | Update each CLI to its latest version on launch (npm reinstall or the official installer script). |
+| `superCli.autoUpdate` | `false` | Run each CLI's update command on launch (when it has one). Off by default — most CLIs self-update. |
+| `superCli.useWsl` | `false` | On Windows, open agents in a WSL terminal instead of the default shell. Ignored on macOS/Linux. |
 
 Run **Super CLI: Open Settings** from the sidebar or the command palette to jump straight to these
 settings.

package-lock.json

@@ -3,7 +3,7 @@
   "displayName": "Super CLI",
   "description": "One VS Code extension to launch any coding agent CLI (Claude Code, Codex, Copilot, Antigravity, and your own) from a single side terminal.",
   "publisher": "mikesoft",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/TheStreamCode/super-cli.git"
@@ -98,6 +98,12 @@
         "category": "Super CLI",
         "icon": "$(play)"
       },
+      {
+        "command": "superCli.updateAgent",
+        "title": "Update Agent",
+        "category": "Super CLI",
+        "icon": "$(arrow-circle-up)"
+      },
       {
         "command": "superCli.refresh",
         "title": "Refresh Agents",
@@ -133,15 +139,24 @@
       "view/item/context": [
         {
           "command": "superCli.launchAgent",
-          "when": "view == superCli.agents && viewItem == agent",
-          "group": "inline"
+          "when": "view == superCli.agents && viewItem =~ /agent/",
+          "group": "inline@1"
+        },
+        {
+          "command": "superCli.updateAgent",
+          "when": "view == superCli.agents && viewItem == agent-updatable",
+          "group": "inline@2"
         }
       ],
       "commandPalette": [
         {
           "command": "superCli.launchAgent",
           "when": "false"
         },
+        {
+          "command": "superCli.updateAgent",
+          "when": "false"
+        },
         {
           "command": "superCli.refresh",
           "when": "false"
@@ -230,6 +245,25 @@
                 "additionalProperties": {
                   "type": "string"
                 }
+              },
+              "updateCommand": {
+                "description": "Optional command to update the CLI to its latest version (its official update/upgrade command, or an npm reinstall). Shown as an update button in the sidebar, and used by superCli.autoUpdate. Use a string, or an object with \"unix\" and \"windows\" keys for OS-specific commands.",
+                "oneOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "unix": {
+                        "type": "string"
+                      },
+                      "windows": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                ]
               }
             }
           }
@@ -256,9 +290,15 @@
         },
         "superCli.autoUpdate": {
           "type": "boolean",
-          "default": true,
+          "default": false,
+          "scope": "window",
+          "description": "Run each coding agent CLI's update command on launch, when it has one. Off by default, since most CLIs already update themselves. Enable to have Super CLI update them before launching."
+        },
+        "superCli.useWsl": {
+          "type": "boolean",
+          "default": false,
           "scope": "window",
-          "description": "Update each coding agent CLI to its latest version on launch, using its install command (npm reinstall, or the official installer script). Disable to launch without updating."
+          "description": "On Windows, open coding agents in a WSL terminal instead of the default shell (uses VS Code's native WSL support). Ignored on macOS and Linux."
         }
       }
     }

package.json

@@ -17,6 +17,7 @@ export interface Agent {
   autoInstall?: boolean;
   ensureConfig?: EnsureConfig;
   env?: Record<string, string>;
+  updateCommand?: InstallCommand;
 }
 
 /** Built-in agent presets shipped with the extension. Users override them by reusing an id. */
@@ -28,6 +29,7 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     icon: 'sparkle',
     installCommand: 'npm install -g @anthropic-ai/claude-code',
     autoInstall: true,
+    updateCommand: 'claude update',
     // Super CLI is one extension for every CLI, so skip Claude Code's IDE extension
     // auto-install using its own official environment variable.
     env: { CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL: '1' },
@@ -39,6 +41,7 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     icon: 'rocket',
     installCommand: 'npm install -g @openai/codex',
     autoInstall: true,
+    updateCommand: 'codex update',
   },
   {
     id: 'copilot',
@@ -47,6 +50,7 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     icon: 'github',
     installCommand: 'npm install -g @github/copilot',
     autoInstall: true,
+    updateCommand: 'copilot update',
   },
   {
     id: 'grok',
@@ -64,6 +68,7 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     icon: 'terminal',
     installCommand: 'npm install -g @kilocode/cli',
     autoInstall: true,
+    updateCommand: 'kilo upgrade',
   },
   {
     id: 'antigravity',
@@ -126,6 +131,7 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     icon: 'flame',
     installCommand: 'npm install -g @charmland/crush',
     autoInstall: true,
+    updateCommand: 'npm install -g @charmland/crush',
   },
   {
     id: 'hermes',
@@ -135,6 +141,7 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     // Official shell installer (no npm package).
     installCommand: { unix: 'curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash' },
     autoInstall: true,
+    updateCommand: 'hermes update',
   },
   {
     id: 'mimo',

src/agents.ts

@@ -1,7 +1,7 @@
 import * as vscode from 'vscode';
 import { type Agent, BUILTIN_AGENTS, resolveAgents } from './agents.js';
 import { AgentTreeDataProvider } from './tree.js';
-import { launchAgent, openExtensionSettings } from './terminal.js';
+import { launchAgent, openExtensionSettings, updateAgent } from './terminal.js';
 
 const SETTINGS_NAMESPACE = 'superCli';
 
@@ -59,6 +59,14 @@ export function activate(context: vscode.ExtensionContext): void {
     await launchAgent(agent, context, terminalSequence++);
   });
 
+  const updateAgentCommand = vscode.commands.registerCommand('superCli.updateAgent', async (agent?: Agent) => {
+    if (!agent) {
+      return;
+    }
+
+    await updateAgent(agent, context);
+  });
+
   const refreshCommand = vscode.commands.registerCommand('superCli.refresh', () => {
     treeProvider.refresh();
   });
@@ -77,6 +85,7 @@ export function activate(context: vscode.ExtensionContext): void {
     treeView,
     launchCommand,
     launchAgentCommand,
+    updateAgentCommand,
     refreshCommand,
     openSettingsCommand,
     configWatcher,

src/extension.ts

@@ -118,8 +118,8 @@ function startGuidedInstall(agent: Agent, installCommand: string): void {
   installTerminal.sendText(installCommand, true);
 }
 
-async function handleMissingAgent(agent: Agent, context: vscode.ExtensionContext): Promise<void> {
-  const installCommand = resolveInstallCommand(agent.installCommand, process.platform);
+async function handleMissingAgent(agent: Agent, context: vscode.ExtensionContext, platform: string): Promise<void> {
+  const installCommand = resolveInstallCommand(agent.installCommand, platform);
 
   if (installCommand && agent.autoInstall) {
     const selection = await vscode.window.showWarningMessage(
@@ -154,14 +154,15 @@ function watchForMissingAgent(
   agent: Agent,
   context: vscode.ExtensionContext,
   runCommand: string,
+  platform: string,
 ): void {
   executeCommandWithOptionalShellIntegration(
     terminal,
     runCommand,
     context,
     async (endEvent, output) => {
       if (shouldPromptToInstall(agent.command, endEvent.exitCode, output)) {
-        await handleMissingAgent(agent, context);
+        await handleMissingAgent(agent, context, platform);
       }
     },
   );
@@ -230,8 +231,11 @@ export async function launchAgent(agent: Agent, context: vscode.ExtensionContext
 
   const configuration = vscode.workspace.getConfiguration(SETTINGS_NAMESPACE);
   const location = configuration.get<string>('terminalLocation', 'beside');
-  const autoUpdate = configuration.get<boolean>('autoUpdate', true);
-  const updateCommand = autoUpdate ? resolveInstallCommand(agent.installCommand, process.platform) : undefined;
+  // WSL only applies on Windows; under WSL the agents use their Unix install/update commands.
+  const useWsl = configuration.get<boolean>('useWsl', false) && process.platform === 'win32';
+  const platform = useWsl ? 'linux' : process.platform;
+  const autoUpdate = configuration.get<boolean>('autoUpdate', false);
+  const updateCommand = autoUpdate ? resolveInstallCommand(agent.updateCommand, platform) : undefined;
   const launchCommand = buildLaunchCommand(command, updateCommand);
   const cwd = resolveTerminalCwd(vscode.window.activeTextEditor, vscode.workspace);
 
@@ -240,8 +244,46 @@ export async function launchAgent(agent: Agent, context: vscode.ExtensionContext
     location: location === 'panel' ? vscode.TerminalLocation.Panel : { viewColumn: vscode.ViewColumn.Beside },
     cwd,
     env: agent.env,
+    shellPath: useWsl ? 'wsl.exe' : undefined,
   });
   terminal.show();
-  watchForMissingAgent(terminal, agent, context, launchCommand);
+  watchForMissingAgent(terminal, agent, context, launchCommand, platform);
   void vscode.window.setStatusBarMessage(`Started ${agent.label}`, 2500);
 }
+
+/** Runs the agent's official update command in a dedicated terminal (without launching the agent). */
+export async function updateAgent(agent: Agent, context: vscode.ExtensionContext): Promise<void> {
+  if (!vscode.workspace.isTrusted) {
+    const selection = await vscode.window.showWarningMessage(
+      `Super CLI runs terminal commands in the current workspace. Trust this workspace before updating ${agent.label}.`,
+      'Manage Workspace Trust',
+    );
+
+    if (selection === 'Manage Workspace Trust') {
+      await vscode.commands.executeCommand('workbench.trust.manage');
+    }
+
+    return;
+  }
+
+  const useWsl = vscode.workspace.getConfiguration(SETTINGS_NAMESPACE).get<boolean>('useWsl', false) && process.platform === 'win32';
+  const platform = useWsl ? 'linux' : process.platform;
+  const updateCommand = resolveInstallCommand(agent.updateCommand, platform);
+
+  if (!updateCommand) {
+    void vscode.window.showInformationMessage(`${agent.label} has no configured update command — it likely updates itself.`);
+    return;
+  }
+
+  const cwd = resolveTerminalCwd(vscode.window.activeTextEditor, vscode.workspace);
+  const terminal = vscode.window.createTerminal({
+    name: `Update ${agent.label}`,
+    location: vscode.TerminalLocation.Panel,
+    cwd,
+    env: agent.env,
+    shellPath: useWsl ? 'wsl.exe' : undefined,
+  });
+  terminal.show();
+  terminal.sendText(updateCommand, true);
+  void vscode.window.setStatusBarMessage(`Updating ${agent.label}`, 2500);
+}

src/terminal.ts

@@ -30,7 +30,7 @@ export class AgentTreeDataProvider implements vscode.TreeDataProvider<Agent> {
     item.id = agent.id;
     item.description = agent.command;
     item.tooltip = `Launch ${agent.label} (${agent.command})`;
-    item.contextValue = 'agent';
+    item.contextValue = agent.updateCommand ? 'agent-updatable' : 'agent';
     item.iconPath = new vscode.ThemeIcon(normalizeIconId(agent.icon) ?? 'terminal');
     item.command = {
       command: 'superCli.launchAgent',

src/tree.ts

@@ -53,6 +53,28 @@ test('OpenCode ships as a built-in preset', () => {
   assert.equal(opencode.installCommand, 'npm install -g opencode-ai');
 });
 
+test('agents with a known update command carry their official one', () => {
+  const expected = {
+    claude: 'claude update',
+    codex: 'codex update',
+    copilot: 'copilot update',
+    kilo: 'kilo upgrade',
+    hermes: 'hermes update',
+    crush: 'npm install -g @charmland/crush',
+  };
+  for (const [id, cmd] of Object.entries(expected)) {
+    const agent = BUILTIN_AGENTS.find((a) => a.id === id);
+    assert.equal(agent.updateCommand, cmd, id);
+  }
+});
+
+test('self-updating CLIs have no manual update command', () => {
+  for (const id of ['opencode', 'cursor', 'droid', 'mimo', 'command-code']) {
+    const agent = BUILTIN_AGENTS.find((a) => a.id === id);
+    assert.equal(agent.updateCommand, undefined, id);
+  }
+});
+
 test('Claude Code skips its IDE extension auto-install via env', () => {
   const claude = BUILTIN_AGENTS.find((a) => a.id === 'claude');
   assert.equal(claude.env.CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL, '1');

test/agents.test.js

@@ -45,6 +45,7 @@ test('package declares the launcher commands', () => {
   assert.deepEqual(commands, [
     'superCli.launch',
     'superCli.launchAgent',
+    'superCli.updateAgent',
     'superCli.refresh',
     'superCli.openSettings',
   ]);