History

Peter Steinberger 4ee70be690 chore: bump version to 2026.1.23		2026-01-23 22:14:56 +00:00
..
src	feat: extend lobster tool run args	2026-01-23 03:09:59 +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	chore: bump version to 2026.1.23	2026-01-23 22:14:56 +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.