Host plugin and MCP
Install the host package, connect to the local daemon and use its five work tools.
Prerequisites
The host process must find openmybot on PATH. It and the daemon must run as the same user with the same data directory. Pass OPENMYBOT_DATA_DIR to the host for a non-default directory.
openmybot bindings host crabcode --workspace /absolute/path/to/workspaceopenmybot bindings host crabcode --workspace /absolute/path/to/workspaceInstall the repository's openmybot/plugin directory using the host's plugin workflow. It contains an Agent Plugins package and a CrabCode manifest; do not install them twice.
Validate and connect
crabcode plugin validate /absolute/path/to/OpenMyBot/openmybot/plugincrabcode plugin validate /absolute/path/to/OpenMyBot/openmybot/pluginThis validates the CrabCode package format, not a live host connection. openmybot mcp speaks stdio and does not accept --json. Supported MCP revisions are 2025-11-25 and 2026-07-28.
Five tools
| Tool | Input and purpose |
|---|---|
wrok_run_begin | operation_id, message: start work |
wrok_run_status | run_id: status and pending permission IDs |
wrok_run_cancel | run_id: request cancellation |
wrok_run_result | run_id: terminal summary and relative artifact paths |
wrok_thread_list | No arguments: up to 50 recent runs |
operation_id is 1–125 characters from letters, digits and ._:-. The message is at most 4096 UTF-8 bytes. Repeating the same ID and message returns the same run; changing the message under that ID conflicts. Use a new ID for different work, not to bypass a retry.
Summaries are retained for seven days. Results before completion return run_not_terminal. These tools cannot approve or deny permissions.
Compatibility
The public record accepts CrabCode 1.1.27; it does not automatically accept wrokCode 1.1.32. Other hosts, including Grok Bot, require real installation, protocol, tool, skill and single-registration checks. See compatibility records.