History

Peter Steinberger 3993c9a3b4 fix: stop BlueBubbles typing on idle/no-reply (#1439 ) (thanks @Nicell)		2026-01-22 21:33:19 +00:00
..
src	fix: retry lobster spawn on windows	2026-01-22 04:31:25 +00:00
clawdbot.plugin.json	fix: stabilize lobster tool subprocess	2026-01-22 03:20:23 +00:00
index.ts	Gate lobster plugin tool in sandboxed contexts	2026-01-17 20:33:31 -08:00
package.json	fix: stop BlueBubbles typing on idle/no-reply (#1439 ) (thanks @Nicell)	2026-01-22 21:33:19 +00:00
README.md	Move lobster integration to optional plugin tool	2026-01-17 20:18:54 -08:00
SKILL.md	Add SKILL.md to teach Clawdbot when/how to use Lobster	2026-01-18 12:11:25 -08:00

README.md

Lobster (plugin)

Adds the lobster agent tool as an optional plugin tool.

What this is

Lobster is a standalone workflow shell (typed JSON-first pipelines + approvals/resume).
This plugin integrates Lobster with Clawdbot without core changes.

Enable

Because this tool can trigger side effects (via workflows), it is registered with optional: true.

Enable it in an agent allowlist:

{
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": {
          "allow": [
            "lobster" // plugin id (enables all tools from this plugin)
          ]
        }
      }
    ]
  }
}

Security

Runs the lobster executable as a local subprocess.
Does not manage OAuth/tokens.
Uses timeouts, stdout caps, and strict JSON envelope parsing.
Prefer an absolute lobsterPath in production to avoid PATH hijack.