opencodekit 0.6.4 → 0.6.5

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.6.4",
+  version: "0.6.5",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {

package/dist/template/.opencode/command/handoff.md

@@ -136,11 +136,11 @@ Branch: [branch]
 
 Saved: .beads/artifacts/<bead-id>/handoffs/<timestamp>.md
 
-Resume: /resume <bead-id>
+━━━━━━━━━━━━━━━━━━━━━━━━
+🔄 Press Ctrl+K to compact session with handoff context
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+The handoff plugin will automatically inject this context into the new session.
 
-Next session will auto-load:
-- This handoff
-- Previous session context (read_session)
-- Git state
-- Bead artifacts
+Alternatively, resume manually: /resume <bead-id>
 ```

package/dist/template/.opencode/lib/lsp/config.ts

@@ -1,8 +1,71 @@
-import { existsSync } from "node:fs";
-import { extname } from "node:path";
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { extname, join } from "node:path";
 import { BUILTIN_SERVERS, EXT_TO_LANG } from "./constants";
 import type { LSPServerConfig } from "./types";
 
+/**
+ * Known paths where OpenCode installs bundled LSP servers
+ * These are checked when the command isn't found in PATH
+ */
+function getOpenCodeDataDir(): string {
+	const home = homedir();
+	switch (process.platform) {
+		case "darwin":
+			return join(home, ".local/share/opencode");
+		case "win32":
+			return join(
+				process.env.APPDATA ?? join(home, "AppData/Roaming"),
+				"opencode",
+			);
+		default: // linux
+			return join(
+				process.env.XDG_DATA_HOME ?? join(home, ".local/share"),
+				"opencode",
+			);
+	}
+}
+
+/**
+ * Find OpenCode's bundled jdtls launcher jar
+ */
+function findOpenCodeJdtls(): string[] | null {
+	const jdtlsDir = join(getOpenCodeDataDir(), "bin/jdtls");
+	const pluginsDir = join(jdtlsDir, "plugins");
+
+	if (!existsSync(pluginsDir)) return null;
+
+	try {
+		const files = readdirSync(pluginsDir);
+		const launcherJar = files.find(
+			(f) =>
+				f.startsWith("org.eclipse.equinox.launcher_") && f.endsWith(".jar"),
+		);
+		if (!launcherJar) return null;
+
+		const configDir = join(
+			jdtlsDir,
+			process.platform === "darwin"
+				? "config_mac"
+				: process.platform === "win32"
+					? "config_win"
+					: "config_linux",
+		);
+
+		if (!existsSync(configDir)) return null;
+
+		return [
+			"java",
+			"-jar",
+			join(pluginsDir, launcherJar),
+			"-configuration",
+			configDir,
+		];
+	} catch {
+		return null;
+	}
+}
+
 export interface ResolvedServer extends LSPServerConfig {
 	id: string;
 }
@@ -58,6 +121,18 @@ export function resolveServer(filePath: string): ResolvedServer | null {
 		}
 	}
 
+	// Special case: Try OpenCode's bundled jdtls for Java files
+	if (ext === ".java") {
+		const jdtlsCommand = findOpenCodeJdtls();
+		if (jdtlsCommand && commandExists("java")) {
+			return {
+				id: "jdtls",
+				command: jdtlsCommand,
+				extensions: [".java"],
+			};
+		}
+	}
+
 	return null;
 }
 
@@ -87,10 +162,17 @@ export function listAvailableServers(): Array<{
 	for (const [id, config] of Object.entries(BUILTIN_SERVERS)) {
 		if (configuredIds.has(id)) continue;
 		const [cmd] = config.command;
+
+		// Special case: jdtls can use OpenCode's bundled version
+		let available = !!cmd && commandExists(cmd);
+		if (!available && id === "jdtls") {
+			available = !!(findOpenCodeJdtls() && commandExists("java"));
+		}
+
 		results.push({
 			id,
 			extensions: config.extensions,
-			available: !!cmd && commandExists(cmd),
+			available,
 		});
 	}
 

package/dist/template/.opencode/lib/lsp/constants.ts

@@ -40,20 +40,45 @@ export const DEFAULT_MAX_REFERENCES = 200;
 export const DEFAULT_MAX_SYMBOLS = 200;
 export const DEFAULT_MAX_DIAGNOSTICS = 200;
 
-// Synced with OpenCode's server.ts
+/**
+ * Built-in LSP servers synced with OpenCode's LSP configuration
+ * @see https://opencode.ai/docs/lsp/
+ *
+ * Servers are matched in order - first match wins.
+ * Some servers (jdtls, pyright, etc.) may use OpenCode's bundled installation.
+ */
 export const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, "id">> = {
+	// TypeScript/JavaScript
 	typescript: {
 		command: ["typescript-language-server", "--stdio"],
 		extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts"],
 	},
+	deno: {
+		command: ["deno", "lsp"],
+		extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs"],
+	},
+
+	// Frontend frameworks
 	vue: {
 		command: ["vue-language-server", "--stdio"],
 		extensions: [".vue"],
 	},
+	svelte: {
+		command: ["svelteserver", "--stdio"],
+		extensions: [".svelte"],
+	},
+	astro: {
+		command: ["astro-ls", "--stdio"],
+		extensions: [".astro"],
+	},
+
+	// Go
 	gopls: {
 		command: ["gopls"],
 		extensions: [".go"],
 	},
+
+	// Python
 	basedpyright: {
 		command: ["basedpyright-langserver", "--stdio"],
 		extensions: [".py", ".pyi"],
@@ -62,10 +87,14 @@ export const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, "id">> = {
 		command: ["pyright-langserver", "--stdio"],
 		extensions: [".py", ".pyi"],
 	},
+
+	// Rust
 	rust: {
 		command: ["rust-analyzer"],
 		extensions: [".rs"],
 	},
+
+	// C/C++
 	clangd: {
 		command: ["clangd", "--background-index", "--clang-tidy"],
 		extensions: [
@@ -81,26 +110,117 @@ export const BUILTIN_SERVERS: Record<string, Omit<LSPServerConfig, "id">> = {
 			".h++",
 		],
 	},
-	svelte: {
-		command: ["svelteserver", "--stdio"],
-		extensions: [".svelte"],
-	},
-	astro: {
-		command: ["astro-ls", "--stdio"],
-		extensions: [".astro"],
-	},
+
+	// Java - OpenCode auto-installs jdtls, requires Java 21+
 	jdtls: {
 		command: ["jdtls"],
 		extensions: [".java"],
 	},
-	lua: {
+
+	// C#/F#
+	csharp: {
+		command: ["OmniSharp", "-lsp"],
+		extensions: [".cs"],
+	},
+	fsharp: {
+		command: ["fsautocomplete", "--adaptive-lsp-server-enabled"],
+		extensions: [".fs", ".fsi", ".fsx", ".fsscript"],
+	},
+
+	// Ruby
+	"ruby-lsp": {
+		command: ["ruby-lsp"],
+		extensions: [".rb", ".rake", ".gemspec", ".ru"],
+	},
+
+	// PHP
+	intelephense: {
+		command: ["intelephense", "--stdio"],
+		extensions: [".php"],
+	},
+
+	// Lua
+	"lua-ls": {
 		command: ["lua-language-server"],
 		extensions: [".lua"],
 	},
+
+	// Shell
+	bash: {
+		command: ["bash-language-server", "start"],
+		extensions: [".sh", ".bash", ".zsh", ".ksh"],
+	},
+
+	// Swift/Objective-C
+	"sourcekit-lsp": {
+		command: ["sourcekit-lsp"],
+		extensions: [".swift", ".objc", ".objcpp"],
+	},
+
+	// Dart
+	dart: {
+		command: ["dart", "language-server", "--protocol=lsp"],
+		extensions: [".dart"],
+	},
+
+	// Elixir
+	"elixir-ls": {
+		command: ["elixir-ls"],
+		extensions: [".ex", ".exs"],
+	},
+
+	// Gleam
+	gleam: {
+		command: ["gleam", "lsp"],
+		extensions: [".gleam"],
+	},
+
+	// Clojure
+	"clojure-lsp": {
+		command: ["clojure-lsp"],
+		extensions: [".clj", ".cljs", ".cljc", ".edn"],
+	},
+
+	// OCaml
+	"ocaml-lsp": {
+		command: ["ocamllsp"],
+		extensions: [".ml", ".mli"],
+	},
+
+	// Zig
+	zls: {
+		command: ["zls"],
+		extensions: [".zig", ".zon"],
+	},
+
+	// Nix
+	nixd: {
+		command: ["nixd"],
+		extensions: [".nix"],
+	},
+
+	// Terraform
+	terraform: {
+		command: ["terraform-ls", "serve"],
+		extensions: [".tf", ".tfvars"],
+	},
+
+	// Typst
+	tinymist: {
+		command: ["tinymist", "lsp"],
+		extensions: [".typ", ".typc"],
+	},
+
+	// YAML
+	"yaml-ls": {
+		command: ["yaml-language-server", "--stdio"],
+		extensions: [".yaml", ".yml"],
+	},
 };
 
-// Extension to language ID mapping
+// Extension to language ID mapping (used for LSP textDocument/didOpen)
 export const EXT_TO_LANG: Record<string, string> = {
+	// TypeScript/JavaScript
 	".ts": "typescript",
 	".tsx": "typescriptreact",
 	".mts": "typescript",
@@ -111,28 +231,109 @@ export const EXT_TO_LANG: Record<string, string> = {
 	".cjs": "javascript",
 	".json": "json",
 	".jsonc": "jsonc",
+
+	// Python
 	".py": "python",
 	".pyi": "python",
+
+	// Go
 	".go": "go",
+
+	// Rust
 	".rs": "rust",
+
+	// C/C++
 	".c": "c",
 	".cpp": "cpp",
 	".cc": "cpp",
 	".cxx": "cpp",
+	".c++": "cpp",
 	".h": "c",
 	".hpp": "cpp",
+	".hh": "cpp",
+	".hxx": "cpp",
+	".h++": "cpp",
+
+	// Java
 	".java": "java",
+
+	// C#/F#
+	".cs": "csharp",
+	".fs": "fsharp",
+	".fsi": "fsharp",
+	".fsx": "fsharp",
+	".fsscript": "fsharp",
+
+	// Ruby
+	".rb": "ruby",
+	".rake": "ruby",
+	".gemspec": "ruby",
+	".ru": "ruby",
+
+	// PHP
+	".php": "php",
+
+	// Lua
 	".lua": "lua",
+
+	// Shell
+	".sh": "shellscript",
+	".bash": "shellscript",
+	".zsh": "shellscript",
+	".ksh": "shellscript",
+
+	// Swift/Objective-C
+	".swift": "swift",
+	".objc": "objective-c",
+	".objcpp": "objective-cpp",
+
+	// Dart
+	".dart": "dart",
+
+	// Elixir
+	".ex": "elixir",
+	".exs": "elixir",
+
+	// Gleam
+	".gleam": "gleam",
+
+	// Clojure
+	".clj": "clojure",
+	".cljs": "clojurescript",
+	".cljc": "clojure",
+	".edn": "edn",
+
+	// OCaml
+	".ml": "ocaml",
+	".mli": "ocaml",
+
+	// Zig
+	".zig": "zig",
+	".zon": "zig",
+
+	// Nix
+	".nix": "nix",
+
+	// Terraform
+	".tf": "terraform",
+	".tfvars": "terraform",
+
+	// Typst
+	".typ": "typst",
+	".typc": "typst",
+
+	// Frontend frameworks
 	".vue": "vue",
 	".svelte": "svelte",
 	".astro": "astro",
+
+	// Web
 	".html": "html",
 	".css": "css",
 	".scss": "scss",
-	".md": "markdown",
+
+	// Config/Data
 	".yaml": "yaml",
 	".yml": "yaml",
-	".sh": "shellscript",
-	".bash": "shellscript",
-	".zsh": "shellscript",
+	".md": "markdown",
 };

package/dist/template/.opencode/memory/handoffs/2025-12-27T103000Z.md

@@ -0,0 +1,76 @@
+# Handoff: test-handoff-plugin
+
+**Created:** 2025-12-27T10:30:00Z
+**Agent:** build
+
+## Provenance
+
+| Key    | Value                                               |
+| ------ | --------------------------------------------------- |
+| Repo   | git@github.com:opencodekit/opencodekit-template.git |
+| Branch | main                                                |
+| Commit | ae38a95f899300419e9b17030268cedc60ebb44f            |
+| Clean  | no                                                  |
+
+## Session Context
+
+**Current Session:** testing handoff plugin
+**Token Usage:** ~50k estimated
+
+Next session can load context with:
+
+```
+read_session("last", project="current")
+```
+
+## Progress
+
+### Completed
+
+- [x] Released v0.6.4 (version bump, changelog, tag, GitHub release)
+- [x] Reviewed Agent-Skills-for-Context-Engineering repo (verdict: mostly theory, not worth stealing)
+- [x] Reviewed Karpathy's hn-time-capsule (verdict: useful patterns)
+- [x] Created handoff plugin (`plugin/handoff.ts`)
+- [x] Updated `/handoff` command to instruct Ctrl+K
+
+### In Progress
+
+- [ ] Testing handoff plugin - verifying it injects context on compaction
+
+### Remaining
+
+- [ ] Commit new handoff plugin and updated command
+- [ ] Test full flow: handoff → Ctrl+K → new session with context
+
+## Context
+
+### Key Files
+
+- `.opencode/plugin/handoff.ts` - New plugin that injects handoff on compaction
+- `.opencode/command/handoff.md` - Updated to tell user to press Ctrl+K
+- `.opencode/plugin/compactor.ts` - Reference for plugin structure
+
+### Decisions Made
+
+- Use `experimental.session.compacting` hook to inject handoff context
+- Only inject handoffs < 1 hour old to prevent stale context
+- Search both `.opencode/memory/handoffs/` and `.beads/artifacts/` for handoffs
+
+### Blockers/Issues
+
+- OpenCode lacks `session.start` hook (Issue #5409) - can't auto-navigate to new session
+- Workaround: User must manually press Ctrl+K after /handoff
+
+## Resume Instructions
+
+1. Commit the new handoff plugin and updated command
+2. Test the full flow: run /handoff, press Ctrl+K, verify context injected
+3. If working, consider adding to v0.6.5 release
+
+**Recommended:** Start next session with `/resume test-handoff-plugin` to auto-load this handoff + previous session context.
+
+## Artifacts
+
+- spec.md: missing
+- research.md: missing
+- plan.md: missing

package/dist/template/.opencode/opencode.json

@@ -109,7 +109,8 @@
     "command_list": ";",
     "leader": "`",
     "session_child_cycle": "ctrl+alt+right",
-    "session_child_cycle_reverse": "ctrl+alt+left"
+    "session_child_cycle_reverse": "ctrl+alt+left",
+    "session_compact": "ctrl+k"
   },
   "mcp": {
     "Framelink MCP for Figma": {
@@ -169,7 +170,8 @@
     "opencode-gemini-auth",
     "@tarquinen/opencode-dcp@latest",
     "@franlol/opencode-md-table-formatter@0.0.3",
-    "./plugin/skill.ts"
+    "./plugin/skill.ts",
+    "./plugin/handoff.ts"
   ],
   "provider": {
     "github-copilot": {
@@ -252,65 +254,62 @@
       "models": {
         "gemini-2.5-computer-use-preview-10-2025": {
           "limit": {
-            "context": 1048576,
+            "context": 880964,
             "output": 65536
           },
           "name": "Gemini 2 5 Computer Use Preview 10 2025"
         },
         "gemini-2.5-flash": {
           "limit": {
-            "context": 1048576,
+            "context": 880964,
             "output": 65536
           },
           "name": "Gemini 2 5 Flash"
         },
         "gemini-2.5-flash-lite": {
           "limit": {
-            "context": 1048576,
+            "context": 880964,
             "output": 65536
           },
           "name": "Gemini 2 5 Flash Lite"
         },
         "gemini-2.5-pro": {
           "limit": {
-            "context": 1048576,
+            "context": 880964,
             "output": 65536
           },
           "name": "Gemini 2 5 Pro"
         },
         "gemini-3-flash-preview": {
           "limit": {
-            "context": 1048576,
+            "context": 880964,
             "output": 65536
           },
           "name": "Gemini 3 Flash Preview"
         },
         "gemini-3-pro-image-preview": {
           "limit": {
-            "context": 1048576,
+            "context": 880964,
             "output": 65536
           },
           "name": "Gemini 3 Pro Image Preview"
         },
         "gemini-3-pro-preview": {
           "limit": {
-            "context": 1048576,
+            "context": 880964,
             "output": 65536
           },
           "name": "Gemini 3 Pro Preview"
         },
         "gemini-claude-opus-4-5-thinking": {
-          "interleaved": {
-            "field": "reasoning_content"
-          },
           "limit": {
-            "context": 200000,
+            "context": 168000,
             "output": 64000
           },
           "name": "Gemini Claude Opus 4 5 Thinking",
           "options": {
             "thinking": {
-              "budget_tokens": 32768,
+              "budgetTokens": 32768,
               "type": "enabled"
             }
           },
@@ -318,23 +317,20 @@
         },
         "gemini-claude-sonnet-4-5": {
           "limit": {
-            "context": 200000,
+            "context": 168000,
             "output": 64000
           },
           "name": "Gemini Claude Sonnet 4 5"
         },
         "gemini-claude-sonnet-4-5-thinking": {
-          "interleaved": {
-            "field": "reasoning_content"
-          },
           "limit": {
-            "context": 200000,
+            "context": 168000,
             "output": 64000
           },
           "name": "Gemini Claude Sonnet 4 5 Thinking",
           "options": {
             "thinking": {
-              "budget_tokens": 32768,
+              "budgetTokens": 32768,
               "type": "enabled"
             }
           },
@@ -342,162 +338,146 @@
         },
         "glm-4.6": {
           "limit": {
-            "context": 128000,
+            "context": 107520,
             "output": 16384
           },
           "name": "Glm 4 6"
         },
         "glm-4.7": {
           "limit": {
-            "context": 128000,
+            "context": 107520,
             "output": 16384
           },
           "name": "Glm 4 7"
         },
         "gpt-5": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5-codex": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 Codex",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5-codex-mini": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 Codex Mini",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5.1": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 1",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5.1-codex": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 1 Codex",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5.1-codex-max": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 1 Codex Max",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5.1-codex-mini": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 1 Codex Mini",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5.2": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 2",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-5.2-codex": {
           "limit": {
-            "context": 400000,
+            "context": 336000,
             "output": 32768
           },
           "name": "Gpt 5 2 Codex",
           "options": {
-            "reasoning": {
-              "effort": "medium"
-            }
+            "reasoningEffort": "medium"
           },
           "reasoning": true
         },
         "gpt-oss-120b-medium": {
           "limit": {
-            "context": 128000,
+            "context": 107520,
             "output": 16384
           },
           "name": "Gpt Oss 120b Medium"
         }
       },
       "name": "ProxyPal",
-      "npm": "@ai-sdk/openai-compatible",
+      "npm": "@ai-sdk/anthropic",
       "options": {
         "apiKey": "proxypal-local",
-        "baseURL": "http://127.0.0.1:8317/v1"
+        "baseURL": "http://127.0.0.1:8317/v1",
+        "includeUsage": true
       }
     },
     "zai-coding-plan": {
       "models": {
         "glm-4.6": {
           "attachment": true,
+          "limit": {
+            "context": 128000,
+            "output": 16384
+          },
           "options": {
-            "reasoningEffort": "high",
             "temperature": 1,
             "thinking": {
               "type": "enabled"
-            },
-            "top_k": 40,
-            "top_p": 0.95
+            }
           },
           "reasoning": true,
           "temperature": true,
@@ -506,20 +486,25 @@
         "glm-4.7": {
           "id": "glm-4.7",
           "interleaved": true,
+          "limit": {
+            "context": 200000,
+            "output": 128000
+          },
           "name": "GLM-4.7",
           "options": {
-            "maxOutputTokens": 131072,
-            "reasoningEffort": "high",
-            "reasoningSummary": "true",
             "temperature": 1,
             "thinking": {
               "type": "enabled"
-            },
-            "top_k": 40,
-            "top_p": 0.95
+            }
           },
           "reasoning": true
         }
+      },
+      "name": "Z.AI Coding Plan",
+      "npm": "@ai-sdk/openai-compatible",
+      "options": {
+        "apiKey": "{env:ZAI_API_KEY}",
+        "baseURL": "https://api.z.ai/api/paas/v4"
       }
     }
   },

package/dist/template/.opencode/package.json

@@ -11,7 +11,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@opencode-ai/plugin": "1.0.202"
+    "@opencode-ai/plugin": "1.0.207"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",

package/dist/template/.opencode/plugin/handoff.ts

@@ -0,0 +1,182 @@
+/**
+ * OpenCode Handoff Plugin
+ * Injects handoff context into session compaction for seamless session transitions
+ *
+ * Workflow:
+ * 1. User runs /handoff command → creates handoff markdown file
+ * 2. User presses Ctrl+K to compact session
+ * 3. This plugin injects the handoff context into the compaction prompt
+ * 4. New session starts with full context from previous session
+ */
+
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join } from "path";
+import type { Plugin } from "@opencode-ai/plugin";
+
+const HANDOFF_DIRS = [
+	".opencode/memory/handoffs",
+	".beads/artifacts", // Check for bead-specific handoffs
+] as const;
+
+interface HandoffFile {
+	path: string;
+	mtime: number;
+	content: string;
+}
+
+function findLatestHandoff(baseDir: string): HandoffFile | null {
+	const handoffs: HandoffFile[] = [];
+
+	for (const dir of HANDOFF_DIRS) {
+		const fullPath = join(baseDir, dir);
+		if (!existsSync(fullPath)) continue;
+
+		try {
+			const files = findMarkdownFiles(fullPath);
+			for (const file of files) {
+				try {
+					const stat = require("fs").statSync(file);
+					const content = readFileSync(file, "utf-8");
+
+					// Only include files that look like handoffs
+					if (
+						content.includes("## Resume Instructions") ||
+						content.includes("## Progress") ||
+						content.includes("# Handoff:")
+					) {
+						handoffs.push({
+							path: file,
+							mtime: stat.mtimeMs,
+							content,
+						});
+					}
+				} catch {
+					// Skip unreadable files
+				}
+			}
+		} catch {
+			// Skip inaccessible directories
+		}
+	}
+
+	if (handoffs.length === 0) return null;
+
+	// Return most recent
+	return handoffs.sort((a, b) => b.mtime - a.mtime)[0];
+}
+
+function findMarkdownFiles(dir: string, depth = 3): string[] {
+	if (depth <= 0) return [];
+
+	const results: string[] = [];
+
+	try {
+		const entries = readdirSync(dir, { withFileTypes: true });
+
+		for (const entry of entries) {
+			const fullPath = join(dir, entry.name);
+
+			if (entry.isDirectory() && !entry.name.startsWith(".")) {
+				results.push(...findMarkdownFiles(fullPath, depth - 1));
+			} else if (entry.isFile() && entry.name.endsWith(".md")) {
+				results.push(fullPath);
+			}
+		}
+	} catch {
+		// Skip inaccessible directories
+	}
+
+	return results;
+}
+
+function formatHandoffForCompaction(handoff: HandoffFile): string {
+	// Extract key sections from handoff
+	const content = handoff.content;
+
+	return `## Previous Session Handoff
+
+<handoff-context>
+${content}
+</handoff-context>
+
+**IMPORTANT**: Resume work from where the previous session left off. Check the "Resume Instructions" section above for specific next steps.`;
+}
+
+export const HandoffPlugin: Plugin = async ({ client, directory }) => {
+	client.app
+		.log({
+			body: {
+				service: "handoff-plugin",
+				level: "info",
+				message: "🔄 Handoff Plugin loaded - session continuity enabled",
+			},
+		})
+		.catch(() => {});
+
+	return {
+		// Inject handoff context when session is being compacted
+		"experimental.session.compacting": async (_input, output) => {
+			const handoff = findLatestHandoff(directory);
+
+			if (!handoff) {
+				client.app
+					.log({
+						body: {
+							service: "handoff-plugin",
+							level: "debug",
+							message: "No handoff found - compacting without handoff context",
+						},
+					})
+					.catch(() => {});
+				return;
+			}
+
+			// Check if handoff is recent (within last hour)
+			const oneHourAgo = Date.now() - 60 * 60 * 1000;
+			const isRecent = handoff.mtime > oneHourAgo;
+
+			if (!isRecent) {
+				client.app
+					.log({
+						body: {
+							service: "handoff-plugin",
+							level: "debug",
+							message: `Handoff found but stale (${new Date(handoff.mtime).toISOString()}) - skipping injection`,
+						},
+					})
+					.catch(() => {});
+				return;
+			}
+
+			// Inject handoff context
+			const formattedHandoff = formatHandoffForCompaction(handoff);
+			output.context.push(formattedHandoff);
+
+			client.app
+				.log({
+					body: {
+						service: "handoff-plugin",
+						level: "info",
+						message: `📋 Injected handoff context from: ${handoff.path}`,
+					},
+				})
+				.catch(() => {});
+		},
+
+		// Log when compaction completes
+		event: async ({ event }) => {
+			if (event.type === "session.compacted") {
+				client.app
+					.log({
+						body: {
+							service: "handoff-plugin",
+							level: "info",
+							message:
+								"✅ Session compacted with handoff context - ready to continue",
+						},
+					})
+					.catch(() => {});
+			}
+		},
+	};
+};

package/dist/template/.opencode/tool/lsp.ts

@@ -3,7 +3,9 @@
  * Semantic code refactoring using Language Server Protocol
  *
  * Provides: lsp_rename, lsp_code_actions, lsp_code_action_apply, lsp_organize_imports
- * Requires: Language servers installed (e.g., typescript-language-server, pyright, gopls)
+ *
+ * Uses OpenCode's bundled LSP servers when available, falls back to system-installed servers.
+ * @see https://opencode.ai/docs/lsp/
  */
 
 import { resolve } from "node:path";
@@ -55,11 +57,16 @@ IMPORTANT: This tool directly modifies files. Review the changes shown in output
 		if (!server) {
 			return `Error: No LSP server available for file type: ${absPath}
 
-Install a language server:
-- TypeScript: npm i -g typescript-language-server typescript
-- Python: npm i -g pyright
-- Go: go install golang.org/x/tools/gopls@latest
-- Rust: rustup component add rust-analyzer`;
+OpenCode supports 30+ languages with built-in LSP servers.
+See https://opencode.ai/docs/lsp/ for the full list.
+
+Common servers:
+- TypeScript: Requires 'typescript' in project dependencies
+- Python: Requires 'pyright' dependency installed
+- Go: Requires 'go' command available
+- Rust: Requires 'rust-analyzer' command available
+- Java: Requires Java SDK 21+ installed (OpenCode auto-installs jdtls)
+- C/C++: Requires 'clangd' available (OpenCode auto-installs for C/C++ projects)`;
 		}
 
 		try {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.6.4",
+	"version": "0.6.5",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"type": "module",
 	"repository": {

package/dist/template/.opencode/pickle-thinker.jsonc

@@ -1,11 +0,0 @@
-{
-  // Ultrathink config for pickle-thinker
-  // mode: "lite" keeps the original behavior (prefix user prompts only).
-  // mode: "tool" adds an extra user turn after each tool result to force deeper analysis.
-  // Note: tool mode increases turns/tokens and may impact subscription limits.
-  "enabled": true,
-  // "lite" | "tool"
-  "mode": "tool",
-  // Change the thinking keyword if you like
-  "prefix": "Ultrathink: "
-}