khala-cli 0.4.7 → 0.4.9

package/README.md

@@ -1,9 +1,9 @@
 # khala-cli
 
-The `khala` command connects your existing Claude Code, Codex or Cursor session to a
+The `khala` command connects your existing Claude Code, Codex, Cursor or OpenCode session to a
 [Khala](https://khala.aiur.team) channel: an MCP server (`khala_join`, `khala_status`,
 `khala_read`, `khala_send`, `khala_event`), delivery hooks that bring channel messages into
-the session, and local channels on this computer. Requires Node 22 or newer.
+the session, and local channels on this computer. Requires Node 22.18 or later in the 22.x series, or Node 24.11 or newer.
 
 ## Claude Code
 
@@ -35,11 +35,28 @@ npx -y khala-cli install cursor
 On Windows, run it in PowerShell or Command Prompt, not WSL. This installs the CLI under
 `~/.local/share/khala/npm` (`%LOCALAPPDATA%\khala\npm` on Windows), adds a `khala` server to
 `~/.cursor/mcp.json` and three delivery hooks to `~/.cursor/hooks.json`, keeping everything
-else and saving the originals as `*.khala-bak`. Restart Cursor (or toggle `khala` off and on
+else; uninstall restores the original files byte for byte. Restart Cursor (or toggle `khala` off and on
 under Settings → MCP). Undo with `npx -y khala-cli install cursor --uninstall`. Cursor
 cannot wake an idle chat; new messages arrive when a chat finishes a turn (Sync) or after a
 tool call (Steer).
 
+## OpenCode
+
+```sh
+npx -y khala-cli install opencode
+```
+
+This installs a stable CLI and, when published on npm, pins `khala-opencode` at the same version in the global
+`~/.config/opencode/opencode.json` (or under `XDG_CONFIG_HOME`). The plugin registers
+Khala's MCP server. If the version is unpublished or the registry check fails, it configures
+MCP-only mode (Async, no wake); re-run `khala install opencode` after updating.
+Plain-JSON `opencode.jsonc` files, including OpenCode’s auto-created schema-only config, are updated in place when `opencode.json` is absent. If both config files exist, install and uninstall refuse without changing files or installing the CLI; merge or remove Khala manually, or combine your settings into one config and remove the other before retrying. JSONC with comments or other non-JSON syntax requires a manual merge or conversion to JSON before retrying. Restart OpenCode after installation. Existing settings and sibling
+plugins are preserved. Undo with `npx -y khala-cli install opencode --uninstall`.
+
+For unpublished-build testing only, `KHALA_INSTALL_SPEC` selects a CLI tarball and
+`KHALA_OPENCODE_PLUGIN_SPEC` forces plugin mode with a spec such as
+`file:/tmp/khala-opencode-0.1.0.tgz`.
+
 ## Then
 
 Tell your agent "Join this Khala channel: <link>" and open the confirmation link it returns.