opencode-agent-kit 1.0.12 → 1.0.13

package/bin/commands/init.mjs

@@ -246,8 +246,13 @@ export async function init(options) {
     }
   }
 
-  // 9. Done
-  console.log(`\n  ✅ opencode-agent-kit installed!\n`);
+  // 9. Write .kit-version for agent update checking
+  const pkgJson = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf-8'));
+  const versionFile = join(opencodeDir, '.kit-version');
+  writeFileSync(versionFile, pkgJson.version + '\n', 'utf-8');
+
+  // 10. Done
+  console.log(`\n  ✅ opencode-agent-kit v${pkgJson.version} installed!\n`);
   console.log(`     Location: ${targetDir}`);
   console.log(`     What you got:`);
   console.log(`       • opencode.json              — 13 agents config with MCP servers`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Multi-stack OpenCode agent toolkit — 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO) with 62 skills, 36 commands, and 6 MCP servers",
   "type": "module",
   "bin": {

package/template/.opencode/agents/it-leader.md

@@ -884,6 +884,25 @@ When `multiple: true`, the user can select several options at once. The result r
 
 ## Session Workflow
 
+### Version Check (Session Start)
+
+At the start of every session, check if `opencode-agent-kit` has an update:
+
+1. Read `.opencode/.kit-version` — if found, this is the installed version
+2. Run `npm view opencode-agent-kit version` to get the latest version on npm
+3. Compare versions (skip check if `.opencode/.kit-version` does not exist)
+4. If the latest version is greater than the installed version, notify the user:
+   ```
+   ╭─ Update Available ─────────────────────────────────────╮
+   │                                                       │
+   │   A newer version of opencode-agent-kit is available: │
+   │   Installed: v{installed}   Latest: v{latest}        │
+   │                                                       │
+   │   Run `npx opencode-agent-kit init` to update.        │
+   │                                                       │
+   ╰───────────────────────────────────────────────────────╯
+   ```
+
 ### Starting a Session
 
 ```markdown

package/template/.opencode/agents/node-backend-developer.md

@@ -326,6 +326,12 @@ Use these prompts across services with this stack.
 
 ## Session Workflow
 
+### Version Check (Session Start)
+Before starting work, check if `opencode-agent-kit` has an update:
+1. Read `.opencode/.kit-version` if it exists
+2. Run `npm view opencode-agent-kit version` to get the latest version
+3. If the latest version > installed version, notify the user to run `npx opencode-agent-kit init`
+
 ### Starting a Session
 - Analyze project structure and identify existing patterns
 - Use question tool to ask the task type (first option marked "(Recommended)")

package/template/.opencode/agents/nuxt-frontend-developer.md

@@ -1471,6 +1471,14 @@ questions: [
 
 ## Session Workflow
 
+### Version Check (Session Start)
+
+Before starting work, check if `opencode-agent-kit` has an update:
+
+1. Read `.opencode/.kit-version` if it exists
+2. Run `npm view opencode-agent-kit version` to get the latest version
+3. If the latest version > installed version, notify the user to run `npx opencode-agent-kit init`
+
 ### Starting a Session
 
 ```markdown

package/template/.opencode/agents/react-frontend-developer.md

@@ -943,6 +943,14 @@ options: [
 
 ## Session Workflow
 
+### Version Check (Session Start)
+
+Before starting work, check if `opencode-agent-kit` has an update:
+
+1. Read `.opencode/.kit-version` if it exists
+2. Run `npm view opencode-agent-kit version` to get the latest version
+3. If the latest version > installed version, notify the user to run `npx opencode-agent-kit init`
+
 ### Starting a Session
 
 ```

package/template/.opencode/instructions/INSTRUCTIONS.md

@@ -378,6 +378,19 @@ flutter analyze                          # Static analysis
 3. Integration tests — Full user flows (integration_test package)
 4. Golden tests — Visual regression (golden_toolkit, alchemist)
 
+---
+
+## opencode-agent-kit Version Check
+
+If `.opencode/.kit-version` exists, your agent toolkit has a recorded installed version.
+
+**At session start**, check for updates:
+1. Read `.opencode/.kit-version` to get the installed version
+2. Run `npm view opencode-agent-kit version` to get the latest
+3. If latest > installed, notify the user with the update command
+
+This applies to IT-Leader (primary) and frontend/backend subagents when called directly.
+
 ## Success Metrics
 
 You are successful when: