Docs
Refer a friend. Get a weekly-quota reset.Friend signs up and uses it → +1 reset (valid 30 days) · up to 10% cash back on their spend.
+1 resetGenerate link

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.

bash
openmybot bindings host crabcode --workspace /absolute/path/to/workspace
openmybot bindings host crabcode --workspace /absolute/path/to/workspace

Install 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

bash
crabcode plugin validate /absolute/path/to/OpenMyBot/openmybot/plugin
crabcode plugin validate /absolute/path/to/OpenMyBot/openmybot/plugin

This 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

ToolInput and purpose
wrok_run_beginoperation_id, message: start work
wrok_run_statusrun_id: status and pending permission IDs
wrok_run_cancelrun_id: request cancellation
wrok_run_resultrun_id: terminal summary and relative artifact paths
wrok_thread_listNo 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.