feat: add uninstall command to remove OpenCode and clean up related files

README.md

@@ -50,6 +50,26 @@ OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bas
 XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash
 ```
 
+### Uninstall
+
+To uninstall OpenCode and clean up all related files:
+
+```bash
+opencode uninstall
+```
+
+This will:
+
+- Automatically detect your installation method (curl, npm, pnpm, bun, brew)
+- Remove the OpenCode binary
+- Delete all data directories (sessions, cache, config, state)
+
+To keep your user data (sessions, config) while removing the binary:
+
+```bash
+opencode uninstall --keep-data
+```
+
 ### Documentation
 
 For more info on how to configure OpenCode [**head over to our docs**](https://opencode.ai/docs).

packages/opencode/src/cli/cmd/uninstall.ts

@@ -0,0 +1,218 @@
+import type { Argv } from "yargs"
+import { UI } from "../ui"
+import * as prompts from "@clack/prompts"
+import { Installation } from "../../installation"
+import { Global } from "../../global"
+import fs from "fs/promises"
+import { $ } from "bun"
+
+async function cleanupPathEntries(installDir: string) {
+  const home = process.env.HOME
+  const xdgConfigHome = process.env.XDG_CONFIG_HOME || `${home}/.config`
+
+  const configFiles = [
+    `${home}/.bashrc`,
+    `${home}/.bash_profile`,
+    `${home}/.profile`,
+    `${home}/.zshrc`,
+    `${home}/.zshenv`,
+    `${home}/.config/fish/config.fish`,
+    `${xdgConfigHome}/zsh/.zshrc`,
+    `${xdgConfigHome}/zsh/.zshenv`,
+    `${xdgConfigHome}/bash/.bashrc`,
+    `${xdgConfigHome}/bash/.bash_profile`,
+  ]
+
+  for (const configFile of configFiles) {
+    await fs
+      .readFile(configFile, "utf-8")
+      .then((content) => {
+        // Remove lines that add opencode to PATH
+        const lines = content.split("\n")
+        const filteredLines = lines.reduce((acc, line, index) => {
+          const prevLine = index > 0 ? lines[index - 1] : ""
+          const isPathLine =
+            prevLine.trim() === "# opencode" && (line.includes(installDir) || line.includes("fish_add_path"))
+          const isCommentLine = line.trim() === "# opencode"
+
+          if (!isPathLine && !isCommentLine) {
+            acc.push(line)
+          }
+          return acc
+        }, [] as string[])
+
+        if (filteredLines.length !== lines.length) {
+          return fs
+            .writeFile(configFile, filteredLines.join("\n"))
+            .then(() => prompts.log.success(`Cleaned up PATH entry from ${configFile}`))
+        }
+      })
+      .catch(() => undefined)
+  }
+}
+
+export const UninstallCommand = {
+  command: "uninstall",
+  describe: "uninstall opencode and clean up all related files",
+  builder: (yargs: Argv) => {
+    return yargs
+      .option("keep-data", {
+        describe: "keep user data (sessions, config, etc.)",
+        type: "boolean",
+        default: false,
+      })
+      .option("method", {
+        alias: "m",
+        describe: "installation method to use",
+        type: "string",
+        choices: ["curl", "npm", "pnpm", "bun", "brew"],
+      })
+  },
+  handler: async (args: { keepData?: boolean; method?: string }) => {
+    UI.empty()
+    UI.println(UI.logo("  "))
+    UI.empty()
+    prompts.intro("Uninstall OpenCode")
+
+    const confirm = await prompts.confirm({
+      message: "Are you sure you want to uninstall OpenCode?",
+      initialValue: false,
+    })
+
+    if (prompts.isCancel(confirm) || !confirm) {
+      prompts.outro("Uninstall cancelled")
+      return
+    }
+
+    const detectedMethod = await Installation.method()
+    const method = (args.method as Installation.Method) ?? detectedMethod
+
+    prompts.log.info("Installation method: " + method)
+
+    // Uninstall via package manager
+    const spinner = prompts.spinner()
+    spinner.start("Uninstalling OpenCode binary...")
+
+    const uninstallBinary = async () => {
+      if (method === "curl") {
+        // For curl installs, binary is in $HOME/.opencode/bin
+        const installDir = `${process.env.HOME}/.opencode/bin`
+        const binFile = `${installDir}/opencode`
+
+        return fs
+          .access(binFile)
+          .then(() => fs.unlink(binFile))
+          .then(() => prompts.log.success(`Removed binary from ${binFile}`))
+          .then(() => cleanupPathEntries(installDir))
+          .catch(() =>
+            prompts.log.warn(`Could not find OpenCode binary at ${binFile}. It may have been removed already.`),
+          )
+      }
+
+      if (method === "npm") {
+        return $`npm uninstall -g opencode-ai`
+          .quiet()
+          .throws(false)
+          .then((result) => {
+            if (result.exitCode !== 0) {
+              spinner.stop("Failed to uninstall binary", 1)
+              prompts.log.error(result.stderr.toString("utf8"))
+            }
+          })
+      }
+
+      if (method === "pnpm") {
+        return $`pnpm uninstall -g opencode-ai`
+          .quiet()
+          .throws(false)
+          .then((result) => {
+            if (result.exitCode !== 0) {
+              spinner.stop("Failed to uninstall binary", 1)
+              prompts.log.error(result.stderr.toString("utf8"))
+            }
+          })
+      }
+
+      if (method === "bun") {
+        return $`bun remove -g opencode-ai`
+          .quiet()
+          .throws(false)
+          .then((result) => {
+            if (result.exitCode !== 0) {
+              spinner.stop("Failed to uninstall binary", 1)
+              prompts.log.error(result.stderr.toString("utf8"))
+            }
+          })
+      }
+
+      if (method === "brew") {
+        return $`brew list --formula sst/tap/opencode`
+          .throws(false)
+          .text()
+          .then((tapFormula) => {
+            const formula = tapFormula.includes("opencode") ? "sst/tap/opencode" : "opencode"
+            return $`brew uninstall ${formula}`
+              .env({
+                HOMEBREW_NO_AUTO_UPDATE: "1",
+              })
+              .quiet()
+              .throws(false)
+          })
+          .then((result) => {
+            if (result.exitCode !== 0) {
+              spinner.stop("Failed to uninstall binary", 1)
+              prompts.log.error(result.stderr.toString("utf8"))
+            }
+          })
+      }
+
+      if (method === "unknown") {
+        prompts.log.warn(`Could not detect installation method. Binary location: ${process.execPath}`)
+        prompts.log.info("You may need to uninstall manually using your package manager.")
+      }
+    }
+
+    await uninstallBinary()
+      .then(() => spinner.stop("Binary uninstalled"))
+      .catch((error) => {
+        spinner.stop("Failed to uninstall binary", 1)
+        if (error instanceof Error) {
+          prompts.log.error(error.message)
+        }
+      })
+
+    // Clean up data directories
+    if (!args.keepData) {
+      const cleanupSpinner = prompts.spinner()
+      cleanupSpinner.start("Cleaning up OpenCode data...")
+
+      const dirsToRemove = [
+        { path: Global.Path.data, name: "data" },
+        { path: Global.Path.cache, name: "cache" },
+        { path: Global.Path.config, name: "config" },
+        { path: Global.Path.state, name: "state" },
+      ]
+
+      for (const { path, name } of dirsToRemove) {
+        try {
+          await fs.rm(path, { recursive: true, force: true })
+          prompts.log.success(`Removed ${name}: ${path}`)
+        } catch (error) {
+          prompts.log.warn(`Could not remove ${name} directory: ${path}`)
+        }
+      }
+
+      cleanupSpinner.stop("Data cleanup complete")
+    } else {
+      prompts.log.info("User data preserved (use without --keep-data to remove)")
+      prompts.log.info(`Data location: ${Global.Path.data}`)
+      prompts.log.info(`Config location: ${Global.Path.config}`)
+    }
+
+    UI.empty()
+    prompts.outro("OpenCode has been uninstalled")
+    UI.println(UI.Style.TEXT_DIM + "Thank you for using OpenCode! Join our community:")
+    UI.println(UI.Style.TEXT_DIM + "  Discord: https://discord.gg/opencode")
+    UI.println(UI.Style.TEXT_DIM + "  GitHub: https://github.com/sst/opencode")
+  },
+}

packages/opencode/src/index.ts

@@ -6,6 +6,7 @@ import { Log } from "./util/log"
 import { AuthCommand } from "./cli/cmd/auth"
 import { AgentCommand } from "./cli/cmd/agent"
 import { UpgradeCommand } from "./cli/cmd/upgrade"
+import { UninstallCommand } from "./cli/cmd/uninstall"
 import { ModelsCommand } from "./cli/cmd/models"
 import { UI } from "./cli/ui"
 import { Installation } from "./installation"
@@ -83,6 +84,7 @@ const cli = yargs(hideBin(process.argv))
   .command(AuthCommand)
   .command(AgentCommand)
   .command(UpgradeCommand)
+  .command(UninstallCommand)
   .command(ServeCommand)
   .command(WebCommand)
   .command(ModelsCommand)

packages/plugin/package.json

@@ -24,4 +24,4 @@
     "typescript": "catalog:",
     "@typescript/native-preview": "catalog:"
   }
-}
+}

packages/sdk/js/package.json

@@ -26,4 +26,4 @@
   "publishConfig": {
     "directory": "dist"
   }
-}
+}