opencode-agent-kit 1.0.18 → 1.1.0

package/bin/init.mjs

@@ -1,21 +1,44 @@
 #!/usr/bin/env node
 
-import { Command } from "commander";
-import { init } from "./commands/init.mjs";
+import { Command } from 'commander';
+import { init } from './commands/init.mjs';
+import { upgrade } from './commands/upgrade.mjs';
+import { doctor } from './commands/doctor.mjs';
+import { uninstall } from './commands/uninstall.mjs';
 
 const program = new Command();
 
 program
-  .name("opencode-agent-kit")
-  .description("Install OpenCode multi-agent toolkit into your project")
-  .version("1.0.0");
+  .name('opencode-agent-kit')
+  .description('Multi-stack OpenCode agent toolkit — 13 specialized AI agents, 60+ skills, 35+ commands')
+  .version('1.0.0');
 
 program
-  .command("init")
-  .description("Initialize .opencode/ configuration in current project")
-  .option("-f, --force", "Overwrite existing files without prompt")
-  .option("-d, --dir <path>", "Target project directory", process.cwd())
-  .option("--skip-install", "Skip npm/bun install step in .opencode/")
+  .command('init')
+  .description('Initialize .opencode/ configuration in current project')
+  .option('-f, --force', 'Overwrite existing files without prompt')
+  .option('-d, --dir <path>', 'Target project directory', process.cwd())
+  .option('--skip-install', 'Skip npm/bun install step in .opencode/')
   .action(init);
 
+program
+  .command('upgrade')
+  .description('Check for and apply the latest version of opencode-agent-kit')
+  .option('-v, --verbose', 'Show detailed upgrade output')
+  .action(upgrade);
+
+program
+  .command('doctor')
+  .description('Diagnose common setup issues in the target project')
+  .option('-d, --dir <path>', 'Target project directory', process.cwd())
+  .option('--fix', 'Show actionable fix suggestions')
+  .action(doctor);
+
+program
+  .command('uninstall')
+  .description('Remove opencode-agent-kit configuration from the target project')
+  .option('-d, --dir <path>', 'Target project directory', process.cwd())
+  .option('-f, --force', 'Skip confirmation prompt')
+  .action(uninstall);
+
 program.parse();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.0.18",
-  "description": "Multi-stack OpenCode agent toolkit — 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO, SonarQube) with 62 skills, 37 commands, and 7 MCP servers",
+  "version": "1.1.0",
+  "description": "Multi-stack OpenCode agent toolkit \u2014 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO, SonarQube) with 62 skills, 37 commands, and 7 MCP servers",
   "type": "module",
   "bin": {
     "opencode-agent-kit": "./bin/init.mjs"
@@ -25,6 +25,13 @@
   "engines": {
     "node": ">=18"
   },
+  "scripts": {
+    "lint": "eslint bin/ --ext .mjs,.js",
+    "format": "prettier --write 'bin/**/*.mjs' '*.md' '*.json'",
+    "format:check": "prettier --check 'bin/**/*.mjs' '*.md' '*.json'",
+    "generate-template": "bash scripts/generate-template.sh",
+    "prepare": "node -e \"try { require('husky').install() } catch {}\""
+  },
   "keywords": [
     "opencode",
     "ai-agent",
@@ -43,6 +50,7 @@
     "devops",
     "seo",
     "sonarqube",
+    "agentmemory",
     "coding-agent",
     "mcp",
     "playwright",
@@ -55,5 +63,11 @@
   "dependencies": {
     "commander": "^13.0.0",
     "fs-extra": "^11.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.4.0"
   }
 }

package/template/.opencode/commands/recall.md

@@ -0,0 +1,19 @@
+Search past session observations and lessons for relevant context. Wraps the `memory_smart_search` and `memory_lesson_recall` MCP tools.
+
+## Usage
+
+```
+/recall [query]
+```
+
+## Instructions
+
+1. Call `memory_smart_search` with the query and `limit: 10` (hybrid BM25 + vector + graph search).
+2. Call `memory_lesson_recall` with the same query and `limit: 5` (lesson search).
+3. Combine results and present to the user:
+   - Group by session
+   - Show type, title, and narrative for each observation
+   - Highlight high-importance observations
+   - Show lessons separately with confidence scores
+4. If no results, suggest 2-3 alternative search terms.
+5. **Never hallucinate results.** Only present what the MCP tools actually return.

package/template/.opencode/commands/remember.md

@@ -0,0 +1,19 @@
+Explicitly save an insight, decision, or learning to agentmemory for future sessions. Wraps the `memory_save` MCP tool.
+
+## Usage
+
+```
+/remember [what to remember]
+```
+
+## Instructions
+
+1. Analyze what needs to be remembered — extract the core insight, decision, or fact.
+2. Extract 2-5 searchable concepts (lowercased keyword phrases). Prefer specific terms ("jwt-refresh-rotation" over "auth").
+3. Extract relevant file paths the memory references.
+4. Call `memory_save` with:
+   - `content` — full text to remember (preserve user's phrasing)
+   - `concepts` — extracted concept list
+   - `files` — extracted file list (empty array if none)
+   - `type` — choose from: pattern, preference, architecture, bug, workflow, fact
+5. Confirm the save and show the concepts tagged so the user knows retrieval terms.

package/template/.opencode/hooks/agentmemory-start.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+set -e
+
+AGENTMEMORY_URL="${AGENTMEMORY_URL:-http://localhost:3111}"
+HEALTH_URL="$AGENTMEMORY_URL/agentmemory/livez"
+
+if ! curl -sf "$HEALTH_URL" > /dev/null 2>&1; then
+  npx @agentmemory/agentmemory > /dev/null 2>&1 &
+  for i in $(seq 1 15); do
+    if curl -sf "$HEALTH_URL" > /dev/null 2>&1; then
+      break
+    fi
+    sleep 1
+  done
+fi
+
+exec npx -y @agentmemory/mcp "$@"

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

@@ -380,6 +380,55 @@ flutter analyze                          # Static analysis
 
 ---
 
+## Agentmemory: Persistent Cross-Session Memory
+
+agentmemory provides persistent memory for all agents. It captures session history, saves decisions/insights, and injects relevant context from past sessions into the current session.
+
+### Prerequisites
+
+```bash
+npm install -g @agentmemory/agentmemory   # Install globally
+agentmemory                                # Start server on :3111
+```
+
+### MCP Tools (53 tools)
+
+All agents have access to agentmemory MCP tools prefixed with `agentmemory_memory_`:
+
+| Tool | Purpose |
+|------|---------|
+| `memory_save` | Save insights, decisions, facts to long-term memory |
+| `memory_recall` | Search past observations by keywords |
+| `memory_smart_search` | Hybrid semantic+keyword search for conceptual queries |
+| `memory_sessions` | List recent sessions with status and observation counts |
+| `memory_file_history` | Get past observations about specific files |
+| `memory_lesson_save` | Save a lesson learned with confidence scoring |
+| `memory_lesson_recall` | Search lessons by query, sorted by confidence |
+| `memory_governance_delete` | Delete specific memories (requires confirmation) |
+| `memory_patterns` | Detect recurring patterns across sessions |
+| `memory_consolidate` | Run 4-tier memory consolidation pipeline |
+
+### Available Commands
+
+- `/recall [query]` — Search past observations and lessons
+- `/remember [text]` — Explicitly save an insight to long-term memory
+
+### Auto-Capture Plugin
+
+The `agentmemory-capture.ts` plugin (registered in `opencode.json`) captures 22 lifecycle events automatically:
+- Session lifecycle: created, idle, compacted, updated, deleted, error
+- Messages & prompts: user messages, assistant responses, removed messages
+- Parts & steps: subagent starts, tool calls, reasoning, step-finish, patches, compaction events
+- File enrichment: auto-injects file-specific context into system prompt
+- Permissions: captures permission prompts and replies
+- Tasks & commands: captures todo changes and command execution
+
+### Skills
+
+The `agentmemory` skill (`.opencode/skills/agentmemory/SKILL.md`) teaches agents when and how to use the memory tools effectively.
+
+---
+
 ## opencode-agent-kit Version Check
 
 If `.opencode/.kit-version` exists, your agent toolkit has a recorded installed version.