mio-agent-runtime 0.5.8 → 0.5.9

package/README.md

@@ -53,6 +53,7 @@ Restart your agent after install. That's it.
 |---------|-------------|
 | `mio init` | Create `~/.mio-intelligence` and default config |
 | `mio install <host>` | Wire MCP + rules + observer into a host |
+| `mio uninstall <host>` | Remove Mio MCP, rules, approvals, and observer from a host |
 | `mio mcp` | Start MCP server (stdio, for agent integration) |
 | `mio status` | Show runtime state, adapter status, observer PID |
 | `mio agents` | List installed hosts |
@@ -237,6 +238,7 @@ WorkBuddy ─┘       + Observer ......... automatic data collection
 | >= 0.3.6 | Passive observation + seamless read/write |
 | >= 0.5.0 | Idea generation + evolution suggestions |
 | >= 0.5.6 | Rewritten documentation |
+| >= 0.5.9 | `mio uninstall <host>` command |
 
 ---
 

package/adapters/codex.js

@@ -119,4 +119,16 @@ function install({ node, serverScript, home, workspace }) {
   }
 }
 
-module.exports = { configPath, isInstalled, install, restartWarningMessage }
+function uninstall({ serverScript }) {
+  const target = configPath()
+  if (!fs.existsSync(target) || !fs.readFileSync(target, 'utf8').includes(SERVER_SECTION)) {
+    return { changed: false, configPath: target, message: 'Codex Mio MCP not installed.' }
+  }
+  const backup = target + '.bak-mio-' + Date.now()
+  fs.copyFileSync(target, backup)
+  const toml = stripMioSection(fs.readFileSync(target, 'utf8'))
+  fs.writeFileSync(target, toml, 'utf8')
+  return { changed: true, configPath: target, backup, message: 'Codex Mio MCP removed. Restart Codex to apply.' }
+}
+
+module.exports = { configPath, isInstalled, install, uninstall, restartWarningMessage }

package/adapters/hermes.js

@@ -119,4 +119,22 @@ function isHermesOnPath() {
   }
 }
 
-module.exports = { hermesBin, isInstalled, install }
+function uninstall({ serverScript }) {
+  if (!hermesBin() && !isHermesOnPath()) {
+    return { changed: false, message: 'Hermes binary not found. Nothing to remove.', configPath: null }
+  }
+  if (!isInstalled()) {
+    return { changed: false, message: 'Hermes Mio MCP not installed.', configPath: null }
+  }
+  runHermes(['mcp', 'remove', SERVER_NAME])
+  const removed = !isInstalled()
+  return {
+    changed: removed,
+    configPath: null,
+    message: removed
+      ? 'Hermes Mio MCP removed. Start a new Hermes session to apply.'
+      : 'Hermes mcp remove returned but Mio is still present. Run `hermes mcp remove ' + SERVER_NAME + '` manually.'
+  }
+}
+
+module.exports = { hermesBin, isInstalled, install, uninstall }

package/adapters/opencode.js

@@ -173,4 +173,43 @@ function install({ node, serverScript, home, workspace, project }) {
   }
 }
 
-module.exports = { configPath, globalInstructionsPath, isInstalled, install, configNeedsRepair, restartWarningMessage }
+function removeGlobalInstructions() {
+  const target = globalInstructionsPath()
+  if (!fs.existsSync(target)) return { changed: false, target, backup: null }
+  const content = fs.readFileSync(target, 'utf8')
+  const start = content.indexOf(INSTRUCTIONS_BEGIN)
+  if (start === -1) return { changed: false, target, backup: null }
+  const end = content.indexOf(INSTRUCTIONS_END, start)
+  let next = end === -1 ? content.slice(0, start) : content.slice(0, start) + content.slice(end + INSTRUCTIONS_END.length)
+  next = next.trimEnd() + '\n'
+  const backup = target + '.bak-mio-' + Date.now()
+  fs.copyFileSync(target, backup)
+  fs.writeFileSync(target, next, 'utf8')
+  return { changed: true, target, backup }
+}
+
+function uninstall({ serverScript }) {
+  const target = configPath()
+  const config = readConfig()
+  const hadMcp = Boolean(config && config.mcp && config.mcp['mio-intelligence'])
+  let configChanged = false
+  let backup = null
+  if (hadMcp) {
+    backup = target + '.bak-mio-' + Date.now()
+    if (fs.existsSync(target)) fs.copyFileSync(target, backup)
+    delete config.mcp['mio-intelligence']
+    if (Object.keys(config.mcp).length === 0) delete config.mcp
+    fs.mkdirSync(path.dirname(target), { recursive: true })
+    fs.writeFileSync(target, JSON.stringify(config, null, 2) + '\n', 'utf8')
+    configChanged = true
+  }
+  const instr = removeGlobalInstructions()
+  const changed = configChanged || instr.changed
+  if (!changed) return { changed: false, configPath: target, message: 'OpenCode Mio MCP not installed.' }
+  let message = 'OpenCode Mio MCP removed'
+  const restartHint = restartWarningMessage()
+  if (restartHint) message += '. ' + restartHint
+  return { changed: true, configPath: target, globalInstructionsPath: instr.target, backup, message }
+}
+
+module.exports = { configPath, globalInstructionsPath, isInstalled, install, uninstall, configNeedsRepair, restartWarningMessage }

package/adapters/workbuddy.js

@@ -193,4 +193,50 @@ function install({ node, serverScript, home, workspace, project }) {
   }
 }
 
-module.exports = { configDir, configPath, approvalsPath, memoryRulesPath, projectInstructionsPath, approvalKey, isInstalled, install }
+function removeBlock(target) {
+  if (!fs.existsSync(target)) return { changed: false, target, backup: null }
+  const content = fs.readFileSync(target, 'utf8')
+  const start = content.indexOf(MEMORY_BEGIN)
+  if (start === -1) return { changed: false, target, backup: null }
+  const end = content.indexOf(MEMORY_END, start)
+  let next = end === -1 ? content.slice(0, start) : content.slice(0, start) + content.slice(end + MEMORY_END.length)
+  next = next.trimEnd() + '\n'
+  const backup = target + '.bak-mio-' + Date.now()
+  fs.copyFileSync(target, backup)
+  fs.writeFileSync(target, next, 'utf8')
+  return { changed: true, target, backup }
+}
+
+function uninstall({ serverScript, workspace }) {
+  const target = configPath()
+  const config = readJson(target)
+  const entry = config && config.mcpServers && config.mcpServers['mio-intelligence']
+  if (!entry) return { changed: false, configPath: target, message: 'WorkBuddy Mio MCP not installed.' }
+  const backup = target + '.bak-mio-' + Date.now()
+  if (fs.existsSync(target)) fs.copyFileSync(target, backup)
+  delete config.mcpServers['mio-intelligence']
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.writeFileSync(target, JSON.stringify(config, null, 2) + '\n', 'utf8')
+  const approvalsTarget = approvalsPath()
+  const approvals = readJson(approvalsTarget) || {}
+  const key = approvalKey('mio-intelligence', entry)
+  if (approvals[key]) {
+    delete approvals[key]
+    fs.writeFileSync(approvalsTarget, JSON.stringify(approvals, null, 2) + '\n', 'utf8')
+  }
+  const userRules = removeBlock(memoryRulesPath())
+  let projectRules = null
+  const workspaceDir = workspace || process.cwd()
+  if (workspaceDir && path.isAbsolute(workspaceDir)) projectRules = removeBlock(projectInstructionsPath(workspaceDir))
+  const changed = userRules.changed || Boolean(projectRules && projectRules.changed)
+  return {
+    changed: true,
+    configPath: target,
+    approvalsPath: approvalsTarget,
+    memoryRulesPath: userRules.target,
+    projectInstructionsPath: projectRules ? projectRules.target : null,
+    message: 'WorkBuddy Mio MCP removed, approval revoked, and Mio rules stripped from CODEBUDDY.md and workspace AGENTS.md. Restart WorkBuddy to apply.'
+  }
+}
+
+module.exports = { configDir, configPath, approvalsPath, memoryRulesPath, projectInstructionsPath, approvalKey, isInstalled, install, uninstall }

package/bin/mio.js

@@ -219,6 +219,49 @@ function observeCommand(args) {
   observer.startForeground(MIO_HOME)
 }
 
+function uninstallCommand(host, useJson) {
+  if (!host) {
+    console.error('Usage: mio uninstall <codex|opencode|workbuddy|hermes>')
+    process.exitCode = 1
+    return
+  }
+  const adapter = adapters[host]
+  if (!adapter) {
+    console.error(`Unknown host: ${host}`)
+    process.exitCode = 1
+    return
+  }
+  let result
+  try {
+    result = adapter.uninstall({
+      node: process.execPath,
+      serverScript: SERVER_SCRIPT,
+      home: MIO_HOME,
+      workspace: process.cwd(),
+    })
+  } catch (error) {
+    console.error(`Failed to uninstall ${host}: ${error.message || error}`)
+    process.exitCode = 1
+    return
+  }
+  if (result.changed) {
+    const config = readConfig()
+    if (config.agents && config.agents[host]) {
+      delete config.agents[host]
+      writeConfig(config)
+    }
+    const remaining = Object.keys(config.agents || {}).length
+    if (remaining === 0 && observer.isRunning(MIO_HOME)) {
+      observer.stopBackground(MIO_HOME)
+    }
+  }
+  if (useJson) {
+    jsonOrText(result, true)
+    return
+  }
+  console.log(result.message || `${host} adapter removed.`)
+}
+
 function help() {
   console.log(`Mio Agent Runtime CLI
 
@@ -227,6 +270,7 @@ Usage:
   mio init                    Initialize MIO_HOME
   mio mcp                     Start Mio MCP server (stdio)
   mio install <host>          Install Mio into a host (codex|opencode|workbuddy|hermes)
+  mio uninstall <host>        Remove Mio from a host
   mio status                  Show runtime and adapter status
   mio agents                  List installed agents
   mio observe                 Watch WorkBuddy transcripts and auto-ingest task outcomes
@@ -253,6 +297,8 @@ function main() {
       return mcpCommand()
     case 'install':
       return installCommand(args[1], useJson)
+    case 'uninstall':
+      return uninstallCommand(args[1], useJson)
     case 'status':
       return statusCommand(useJson)
     case 'agents':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mio-agent-runtime",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "Mio Agent Runtime installer and MCP intelligence layer",
   "license": "MIT",
   "type": "commonjs",