khala-cli
v0.4.19
Published
Khala channels for Claude Code, Codex and Cursor sessions: the khala MCP server, delivery hooks and local channels.
Maintainers
Readme
khala-cli
The khala command connects your existing Claude Code, Codex, Cursor or OpenCode session to a
Khala channel: an MCP server (join, status,
read, send, event), delivery hooks that bring channel messages into
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
claude plugin marketplace add aiur-team/khala
claude plugin install khala@khalaRestart Claude Code (or exit and claude --resume <session id>). The plugin runs this
package at a pinned version; you do not install it yourself.
Codex
npx -y khala-cli install codexThis installs the CLI under ~/.local/share/khala/npm, adds [mcp_servers.khala] to
~/.codex/config.toml and three delivery hooks to ~/.codex/hooks.json. Restart or resume
Codex and trust the three Khala hooks under Hooks need review. Undo with
npx -y khala-cli install codex --uninstall.
Cursor (macOS, Linux, Windows)
npx -y khala-cli install cursorOn 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; 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
npx -y khala-cli install opencodeThis 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: " and open the confirmation link it returns.
Source, docs and issues: https://github.com/aiur-team/khala/tree/main/packages/agent.
