armin-opencode 0.1.4 → 0.1.5

package/README.md

@@ -5,7 +5,6 @@ for AI coding agents — packaged for [opencode](https://opencode.ai).
 
 ```bash
 npx armin-opencode install      # or: npm i -g armin-opencode && armin install
-export ARMIN_ENABLED=1
 ```
 
 Prefer a global install over one-off `npx` runs: the plugin registration
@@ -13,8 +12,9 @@ points at the package's install location, and `npx` caches are evicted.
 
 `armin install` downloads the `armin-engine` sidecar binary for your platform
 from the [GitHub releases](https://github.com/bastian-seifert/armin/releases)
-and registers the plugin in your global opencode config. Enable it per
-environment with `ARMIN_ENABLED=1`.
+and registers + enables the plugin in your global opencode config
+(`"armin": { "enabled": true }`). `ARMIN_ENABLED=1` remains as a
+per-environment escape hatch.
 
 See the [main repo](https://github.com/bastian-seifert/armin) for what the
 agent gets (durable decisions/rules/open items, scoped reasoning-state brief,

package/bin/armin.js

@@ -148,8 +148,8 @@ function registerPlugin() {
     try {
       data = JSON.parse(text.replace(/^\s*\/\/.*$/gm, ""));
     } catch {
-      console.log(`\nCould not parse ${cfgPath} — register the plugin manually:\n  add "plugin": ["file://${plugin}"] to your opencode config\n`);
-      return;
+      console.log(`\nCould not parse ${cfgPath} — set up manually:\n  add "plugin": ["file://${plugin}"] and "armin": { "enabled": true } to your opencode config\n`);
+      return false;
     }
   }
   const entry = "file://" + plugin;
@@ -160,6 +160,12 @@ function registerPlugin() {
     data.plugin = plugins;
     changed = true;
   }
+  // `armin install` is an explicit opt-in — enable in config so no
+  // per-shell env var is needed (ARMIN_ENABLED stays as escape hatch).
+  if (data.armin?.enabled !== true) {
+    data.armin = { ...(data.armin || {}), enabled: true };
+    changed = true;
+  }
   if (pendingTypesafeKey && !process.env.TYPESAFE_AI_API_KEY) {
     data.armin = { ...(data.armin || {}), typesafeKey: pendingTypesafeKey };
     changed = true;
@@ -180,6 +186,7 @@ function registerPlugin() {
     fs.writeFileSync(cfgPath, JSON.stringify(data, null, 2));
   }
   console.log(`plugin registered in ${cfgPath}`);
+  return true;
 }
 
 async function install() {
@@ -202,7 +209,7 @@ async function install() {
     }
   }
   await askForExtractionSetup();
-  registerPlugin();
+  const registered = registerPlugin();
   const tsKey = process.env.TYPESAFE_AI_API_KEY || pendingTypesafeKey;
   const orKey = process.env.OPENROUTER_API_KEY || pendingOpenrouterKey;
   const llmKey = process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY;
@@ -228,11 +235,12 @@ async function install() {
   }
   console.log(`
 ── done ────────────────────────────────────────────────────────
-Enable ARMIN per environment:
-
-    export ARMIN_ENABLED=1
+${registered
+    ? 'ARMIN is enabled in your opencode config ("armin": { "enabled": true }).\nRestart opencode to activate it; remove "enabled" to turn it off.'
+    : "ARMIN is not enabled yet — follow the manual setup steps above."}
 
-Optional:
+Optional overrides (env wins over config):
+    ARMIN_ENABLED=1                force-enable without the config entry
     ARMIN_EXTRACTION_MODE=jev      System One extraction (default; needs
                                    TYPESAFE_AI_API_KEY or OPENROUTER_API_KEY)
     ARMIN_JEV_PROVIDER=openrouter  route jev via OpenRouter (auto-detected

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "armin-opencode",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "ARMIN — queryable decision memory for AI coding agents. Installs the armin-engine sidecar and registers the opencode plugin.",
   "license": "Apache-2.0",
   "author": "Bastian Seifert",