Add OpenCode preset and guided install for npm-based built-ins

- Add OpenCode (opencode, npm: opencode-ai) to the built-in agent presets.
- Enable a guided install with the official command for the npm-installable
  built-ins (Claude Code, Codex, Copilot, Gemini, OpenCode): when the command is
  not found, Super CLI offers to install it after explicit confirmation.
- Grok, Kilo, and Antigravity use OS-specific shell installers and are left out
  of auto-install to avoid shipping a non-cross-platform command.

Author: TheStreamCode

CHANGELOG.md

@@ -3,6 +3,14 @@
 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.2.0]
+
+- 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 `installCommand`
+  for your platform if you want one.
+
 ## [0.1.0]
 
 - Initial release.

README.md

@@ -5,7 +5,7 @@
 [![CI](https://github.com/TheStreamCode/super-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/TheStreamCode/super-cli/actions/workflows/ci.yml)
 
 One VS Code extension to launch any coding agent CLI — **Claude Code, Codex, GitHub Copilot CLI,
-Gemini, Grok, Kilo, Antigravity, and your own** — from a single sidebar and a side terminal.
+Gemini, Grok, Kilo, Antigravity, OpenCode, and your own** — from a single sidebar and a side terminal.
 
 Works on Windows, macOS, and Linux, and across the VS Code family (VS Code, Cursor, Antigravity,
 Windsurf).
@@ -31,10 +31,13 @@ You can also open the Extensions view in VS Code (or Cursor, Antigravity, Windsu
 - **One launcher for every agent.** A **Super CLI** view in the activity bar lists all configured
   agents; click one to open it in a terminal beside your editor. A toolbar button and the
   **Super CLI: Launch Coding Agent** command open a quick pick of the same list.
-- **Built-in presets.** Claude Code, Codex, GitHub Copilot CLI, Gemini, Grok, Kilo, and Antigravity
-  are available out of the box.
+- **Built-in presets.** Claude Code, Codex, GitHub Copilot CLI, Gemini, Grok, Kilo, Antigravity, and
+  OpenCode are available out of the box.
 - **Add your own, no code required.** Define new agents in `settings.json`. The sidebar updates
   automatically.
+- **Guided install.** If a built-in CLI that installs from npm (Claude Code, Codex, Copilot, Gemini,
+  OpenCode) isn't found, Super CLI offers to install it with its official command — after explicit
+  confirmation.
 - **Native integrated terminal.** Each agent runs in a real VS Code terminal, inheriting your
   shell, `PATH`, and environment. No bundled emulator, no runtime dependencies.
 

package.json

@@ -3,7 +3,7 @@
   "displayName": "Super CLI",
   "description": "One VS Code extension to launch any coding agent CLI (Claude Code, Codex, Copilot, Gemini, and your own) from a single side terminal.",
   "publisher": "mikesoft",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/TheStreamCode/super-cli.git"
@@ -156,7 +156,7 @@
             "properties": {
               "id": {
                 "type": "string",
-                "description": "Unique identifier. Reuse a built-in id (claude, codex, copilot, gemini, grok, kilo, antigravity) to override that built-in."
+                "description": "Unique identifier. Reuse a built-in id (claude, codex, copilot, gemini, grok, kilo, antigravity, opencode) to override that built-in."
               },
               "label": {
                 "type": "string",
@@ -186,7 +186,7 @@
           "type": "boolean",
           "scope": "machine",
           "default": true,
-          "description": "Include the built-in agent presets (Claude Code, Codex, Copilot, Gemini, Grok, Kilo, Antigravity) in the launcher."
+          "description": "Include the built-in agent presets (Claude Code, Codex, Copilot, Gemini, Grok, Kilo, Antigravity, OpenCode) in the launcher."
         },
         "superCli.terminalLocation": {
           "type": "string",

src/agents.ts

@@ -16,25 +16,31 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     command: 'claude',
     icon: 'sparkle',
     installCommand: 'npm install -g @anthropic-ai/claude-code',
+    autoInstall: true,
   },
   {
     id: 'codex',
     label: 'Codex CLI',
     command: 'codex',
     icon: 'rocket',
+    installCommand: 'npm install -g @openai/codex',
+    autoInstall: true,
   },
   {
     id: 'copilot',
     label: 'GitHub Copilot CLI',
     command: 'copilot',
     icon: 'github',
     installCommand: 'npm install -g @github/copilot',
+    autoInstall: true,
   },
   {
     id: 'gemini',
     label: 'Gemini CLI',
     command: 'gemini',
     icon: 'star-full',
+    installCommand: 'npm install -g @google/gemini-cli',
+    autoInstall: true,
   },
   {
     id: 'grok',
@@ -54,6 +60,14 @@ export const BUILTIN_AGENTS: readonly Agent[] = [
     command: 'agy',
     icon: 'globe',
   },
+  {
+    id: 'opencode',
+    label: 'OpenCode',
+    command: 'opencode',
+    icon: 'code',
+    installCommand: 'npm install -g opencode-ai',
+    autoInstall: true,
+  },
 ];
 
 /** Returns true when a value is a usable agent definition (non-empty id and command). */

test/agents.test.js

@@ -45,3 +45,19 @@ test('resolveAgents skips entries without a usable id or command', () => {
 
   assert.deepEqual(agents.map((agent) => agent.id), ['good']);
 });
+
+test('OpenCode ships as a built-in preset', () => {
+  const opencode = BUILTIN_AGENTS.find((agent) => agent.id === 'opencode');
+  assert.ok(opencode);
+  assert.equal(opencode.command, 'opencode');
+  assert.equal(opencode.installCommand, 'npm install -g opencode-ai');
+});
+
+test('npm-installable built-ins offer a guided install with their official command', () => {
+  for (const id of ['claude', 'codex', 'copilot', 'gemini', 'opencode']) {
+    const agent = BUILTIN_AGENTS.find((a) => a.id === id);
+    assert.ok(agent, `expected built-in ${id}`);
+    assert.match(agent.installCommand, /^npm install -g /);
+    assert.equal(agent.autoInstall, true);
+  }
+});